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はじめに 


1995年1丨月に Windows 95が発売され、もはやほとんどパーソナルコンピュータは Windows 95をブラ 
ットフォームにし、より安全でより高速、そしてより簡単なアブリケーションにシフトしつつあります0 
これらのアプリケーションは、 Windows 95や WindowsNT 3.5 1に搭載されている Win32 API と呼ばれる32 
ビット対応の API をベースにビルドされています。 API とは、 MS-DOS で言うところのファンクションコ 
ール (int 21h) に相当するものです0つまり、アブリケーションはおろか Windows のシステム自体がこ 
の Win32 API の上に成り立っているのです。 

しかし、 Win32 API に関するドキュメントは、すべて英語で提供されており、その摄も膨大です。そ 
こで、本書では Windows ブログラミングをする上で必須となる API を300個に絞り込み説明しています0 
Visual C++ からはもちろん、簡単に API を呼び出せる Visual Basic からの API の呼び出し方についても併記 
しました。 

本#では、 Visual C++ や Visual Basic での言語形態や開発環境の操作は説明していません。これらの情 
報は、添付のマニュアルや市販害锫をご覧ください。また、 Windows プログラミングの基礎について、 
第1章で簡単に紹介はしていますが、これだけではすべてを語れません。これらの情報については、市 
販搽緖などを合わせてご览ください。何かの参考になるかと思い、次に参考資料も掲載します。 

また、本杏の内容については万全を期していますが、ブログラム開発を行う場合は、各種ヘッダファ 
イルや SDK などと合わせて十分なチェックを行ってください。 
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第 1 章 Windows アプリケーションと Win 32 API 


1.1 Windows アプリケーションの動作 

ここでは、 Windows システムと Windows アブリケーションがどのように連携し 
て動作しているかを説明する。 

1 . 1.1 Windows システムの構成 


Windows Operating System は、単体のプログラムモジュールで構成されたもの 
ではない 。 DLL (ダイナミックリンクライブラリ）と呼ばれる多数のライブラリ 
を利用してつくられた一連のシステムが' Windows である 0 
DLL の中でも非常に重要な役割を担うのが" kernel 32. dll ", " gdi 32. dll "， 
" user 32. dll 1 •である。これらの DLL は、 Windows システム自体を構成するだけでは 
なく、アブリケーシヨンを開発する際に避けては通れない閲数を多数実装してい 
る0 

それぞれの DLL は役割分担されており、 DLL ごとに管理するハードウェアやソ 
フトウェアのリソース（资源）が異なる0 
•• kemel 32. dll ••には、メモリや外部記愤装 f けなどのハードウェアを管理するため 
の関数がまとめられている。 " gdi 32. dll " には、線を描いたり色を塗ったりといっ 
たグラフィックの描画を中心とした関数がまとめられている。また" user 32. dll ” に 
は、ウインドウやボタン、メニュー操作などのユーザーインターフェイスを管理 
するための関数がまとめられている。 
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1.1 Windows アプリケーションの動作 



メッセージ駆動型ブログラム 


Windows アプリケーションの敁大の特徴は、ユーザーがメニューを選択したり、 
タイマーが指定時間に達したりといったアクション（イベント）をきっかけにブ 
ログラムが実行されることである。 

なんらかのイベントが発生すると Windows のシステムがこれを感知し、これを 
「メッセージ」と呼ばれる形に変換する。このメッセージは、 Windows で実行中 
のアプリケーションに送信される。メッセージを受け取ったアブリケーションは、 
ここではじめてメッセージに応じた処理を行うのである。 

このように Windows アプリケーションは、メッセージ（イベント）により駆勋 
するためイベント駆動型のアブリケーシヨンと呼ばれる。 



メッセ—ジマップ 


OnLButtonDown 


OnLFileOpen OnLButtc 

メッセージ八ンドラ：関数の呼び出し 


ンの特徴 


Windows アプリケーシ 


フレ—ムワ—ク 
ォブジェクト 
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1.1.3 メッセージ 


Windows システムでは、イベントに対応して多数のメッセージが発生している。 
このメッセージをキューに貯めて、各アブリケーシヨンに振り分ける。 




T WM LBOHONOOWN 



デスクトッブ 


メモ !^ 1 



WM 一 MOUSEMOVE 


WM INITMENU 
WM.MOUSEMOVE 


■ 
•如=編_1 




ブ□グラム 

発生したメッセージ順に 
各アブリケーシヨンが対 
応する処理を行う 


Windows のシステムで発生する主要なメッセージには、 WM で始まる名前が付け 
られている。主要な Windows メッセージは、以下の通りである 0 
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Windows アプリケーシヨンの動作 


主要メッセージの一览表 


WM.COMMAND 


WM.CREATE 


WM_DESTROY 


WM.DROPFILES 


WM 一 HSCROLL 


WM.INITDIALOG 


WMJNITMENU 


WM^LBUTTONDBLCLK 


WM.LBUTTONDOWN 


WM.LBUTTONUP 


WM.MOUSEMOVE 


WM 一 MOVE 


WM 一 QUIT 


WM-PAINT 


WM. 


WM.RBUTTONDOWN 


WM.RBUTTONUP 


WM.SYSTEMERROR 


WMJHMER 


WM-VSCROLL 


コマンドメツセージが送られてきた 


E 


インドウの作成の指示 


ウインドウの破棄の指示 


ファイルがドロップされた 


水平スクロールノ（一がクリックされた 


ダイアログボックスの初期化要求 


メニューがアクティブになる通知 


マウスの左ボタンがダブルクリックされた 


マウスの左ボタンが押された 


マウスの左ボタンが離された 


E 


マウスカーソルが移動した 


インドウの位 S が変更された 


ンの終了が要求された 


ウインドウの再描画の要求 


マウスの右ボタンがダブルクリックされた 


マウスの右ボタンが押された 


マウスの右ボタンが離された 


システム エラーが 発生した 


タイマのタイムアウト時間が経過した 


垂直スク□一)レノて一がクリックされた 
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1.1.4 リソース 


Windows ブログラムでは、よく「リソース」という言葉が使われる。直訳する 
と「資源」となる0「リソースが足りない」という言葉をよく耳にするが、日本 
語では「資源が足りない」と訳せるだろう。つまり、ブログラムで利用している 
何らかの資源が足りないということだ。では、リソースの実体を説明する0 

•ハードウェアリソース 

ブログラムから利用できる一番身近な物は、メモリやハードディスクだろう。 
通信用ポートやブリンタ、 CPU もそうだ。つまり、コンピュータを構成している 
部分は、すべてリソースと言える0 

•ソフトウェアリソース 

プログラムから利用できるハードウェア以外の物と言えば、ビットマップやフォ 
ントがそうだ 0 次に Windows プログラムでリソースと呼ばれるリストを揭敕する 0 


主要なリソース 

アクセ ラレータ 

ビットマップ 

カーソル 

ダイア□グ 

アイ□ン 

メニュー 

ストリングテーブル 

ツールバー 

バージヨン 


Windows アブリケーシヨンの実行ファイル （ EXE ) や後述の DLL ファイルに 
は、リストのリソースを組み込むことか可能である。それ以外にも、バイナリデ 
一夕を含むことができる。 

作成したリソースはリソースコンパイラを使用してコンパイルし、ブログラム 
のオブジェクトファイルとリンクして実行ファイルに格納する0 

プログラム中では、 LoadResource ， LoadMenu や Loadlcon などの API 関数で呼び 
出すことが'できる。ブログラム中で個々のリソースを指定できるように、リソー 
ス名や ID を割り当てておくことが必要である0 
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1.1 Windows アプリケーションの動作 


DLL - ダイナミックリンクラィブラリ- 


MS - DOS アブリケーションのように、利用する関数をすべて実行ファイルに組 
み込むことは可能である。しかし、複数のアブリケーションが'動作する Windows 
では、间じような関数がアプリケーションごとに組み込まれ、メモリの無駄逍い 
になってしまう。 

可能な限りリソース（資源）の共有をはかり、ハードディスクなどの記愤装骰 
を始めメモリリソースなどの消货を M •小限に抑えるアブリケーシヨンを開発する 
にこしたことはない。 




USER 32 .DLL 


MYDLL.DLL 


使用する関数をすべて実行 使用する関数を動的に組み込 

ブ□グラムに組み込んだ場合 み複数のブ□グラムで共有す 

る場合 
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そのため Windows では、ライブラリの関数をアブリケーションから動的に呼び 
出す機能が提供されている。この機能を利用すると、呼び出そうとしている関数 
が、すでに別のアブリケーションによりメモリに常駐されていれば、その関数を 
共有することが可能である。これにより、メモリをより有効に利用できる。 

このように動的に呼び出される関数群を実装したファイルは 、 DLL (Dynamic 
Link Library :ダイナミック•リンク•ライブラリ）と呼ばれる。 DLL からの関数 
の読み込みは、実行アブリケーションの起動時もしくは、ブログラム中の任意の 
箇所から行える。 

DLL から読み込まれた関数はメモリに常駐し、他のアプリケーションから読み 
込みが要求された場合に共有される仕組みになっている。 DLL には関数ばかりで 
はなく、アイコンや メニュー、 マウスカーソルなどの各種のリソースも実装可能 
である。 


時間 


DLL □— ド 



1.1 Windows アプリケーションの 動作 


1.1.6 MS - DOS ブ□グラムからの移行 


MS-DOS はシングルタスクの OS だったため、 MS-DOS アプリケーシヨンが'リソ 
ースを独占してもなんら問題はなかった 0 しかし、 Windows はマルチタスク OS の 
ため、 Windows アブリケーションは、システムのさまざまなリソースを共有でき 
るようにしなければならない。 

また Windows アブリケーションは、イベント駆動型のため従来の MS-DOS アブ 
リケーシヨンのように、一連の手続きをコーデイングしていくプログラミングス 
タイルとは異なっている。 

ここでは、今まで MS-DOS アプリケーションを開発していた人たちが、 Windows 
アブリケーションを開発する際に注意しなければならないことを説明する0 

籲プログラミングスタイルの違い 

MS-DOS アプリケーションは CPU の制御を行うことができ、ハードウェアやソ 
フトウェアの資源を独占することか可能だった。これは言い換えれば、すべての 
管理をアプリケーションで処理しなくてはならず、ユーザーに対するインターフ 
ェイスなどの入出力部分もアブリケーションごとに作成しなくてはならないとい 
うことである。 

これに対して Windows アプリケーションは、前述の通りイベント駆動アブリケ 
ーションである。たとえば、実行中のアブリケーションのウインドウの中でマウ 
スをクリックすると（マウスクリックのイベントが発生すると）、 Windows のシス 
テムがアブリケーションに対して、マウスがクリックされたというメッセージを 
送る。アブリケーションプログラム側では、メッセージに応じた処理を行 1 う。 





名前7山田 ■ 


Wtndo^ •示 

1 

WWkJowI * 承 



生蓴月日の入力 


C 



名_の入力 


生年月日？ 1967/S/11_ 


今日のの*傳 



プ〇グラムエンド 


今イア a グポフク； u 
ok ポタンが霈された 


生*れてから角 B か tftll 


•〜は〜 B _ 金きています • の褒示 山田は 


日生#ています • 



■ 

_ W： _ 

今 B の日付*爾 

1 

ダイア a グボックス惫渴す 

■ 

_置 

生年月日テキストボックス*得 


wmdaw2 へ■る 

_ ■ _ 

_ L 


生まれてから爾日かを ttll 



名鱗テキストボックス*得 







山田は)000(日 

生？ 

1 OK | ^ 


MS-DOS 

アプリケーシヨ 



Windows アブリケーシヨ 
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また、 Windows ではハードウェアの違いを Windows のシステム側で吸収し、ア 
ブリケーション側ではほとんど気にする必要はない。たとえば、様々な種類のビ 
デオアクセラレータボードか If 在するが、適合したディスプレイドライバを使用 
すれば、アブリケーション側では解像度や色数のみに留意すれば良い0 

•GUI 

MS-DOS アプリケーションと Windows アプリケーションを 比較す ると、 一番 大 
きな違いは GUI (グラフィックユーザーインターフェイス）であろう 〇 Windows 
アプリケーションは名前の通り、ウィンドウシステムの GUI を採用している0 
これに対して MS-DOS は CU 1 (キャラクタユーザーインターフェイス）である0 
ユーザー インターフェイスの基本は文字ベースである0もちろん GUI を採用した 
アプリケーションも存在するが、アブリケーション独自の GUI のサブシステムを 
組み込んでいるためである。 Windows は OS が GUI ベースで設計されているので、 
容易に GUI ウィンドウを 採用 したブログラムが作成できる 0 

さらに、アブリケーションが異なっても同様のインターフェイスで操作できる 
ので、アプリケーシヨンごとに操作を覚える必要が少なくなる0 


籲マルチタスク環境 

Windows はマルチタスクを実現するため、ハードウェア.ソフトウェアのリソ 
ースを複数のアプリケーションが共有できるようになっている。しかし、かつて 
の16ビット Windows では CPU が直接タスクを切り替えるのではなくアブリケーシ 
ョンに動作を任せた、疑似マルチタスクであるため、1つのアブリケーションが夕 
スクを独占してしまうと、他のアプリケーションに制御が移らない場合もあり得 
た。 

現在主流の32ビット Windows (Windows 95> Windows NT) ではプリエンファ 
ィブなタイムスライス.マルチタスキングが OS によって実行されているので、基 
本的にあるアブリケーシヨンプログラムがシステムを占有してしまうことはでき 
ない。 


•API 

Windows には多数の Windows API (アプリケーションブログラムインターフェ 
イス）関数が用意されている0この API 関数とは Windows から提供される MS- 
DOS のファンクションコールのようなものである0 MS-DOS ブログラムでは BIOS 
を使用しなくてもアプリケーションは作成できるが、 Windows プログラムは API 
を使用しなくては何もできない0ウィンドウの表示から文字の出力まで、すべて 
API を呼び出す必要がある0もちろん、直接フアンクシヨンコール （int21h) を 
呼び出すこともできない0 
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1.2 Win32 API 


•ファイル形式 

Windows の実行ファイル形式の拡張子は EXE であるが、内部は MS-DOS のファ 
イルの構造とは異なっている。 MS-DOS で作成した拡張子が EXE または COM 形 
式のファイルを実行すると、 MS-DOS モードで実行される。 Windows ブログラム 
の EXE ファイルには、アイコンやメニューなどのリソースを含むことが'できる。 

また、 Windows では拡張子が DLL のファイルを動的にロー ドすることができる 0 
DLL ファイルは、 Windows システムの API と同様に呼び出しが可能である。 DLL 
ファイルは閲数を含んだファイルと考えると良いだろう。もちろんリソースも含 
むことができる。 


1.2 Win 32 API 


Windows アプリケーシヨンと Windows API が切っても切り離せない154]係にある 
のは、十分理解していただけたであろう。 CPU が8ビット、16ビット、32ビット 
と進化すると同時に、 OS も進化を遂げている 0 Windows もまたしかり、 
Windows 3.1 では 「 Winl 6 API 」 と呼ばれる16ビット Windows API が実装されて 
いたが 、 WindowsNT 3.51や Windows 95では32ビット API の 「 Win 32 API 」 が実 
装されている。 

ここでは、 Win 32 API を利用する上での注意点などを説明する。 

1.2.1 Win 32 API の機能概要 


32ビツト対応の Windows アプリケーションを実行させるには、 Windows 3.1 に 
Win 32 s と呼ばれる追加 API セツトを導入する方法と、 Windows 95や Windows NT 
を利用する方法がある。 Windows 3.1+ Win 32 s は、サブセツト API のため本書で 
は触れない。 

次表は、 Winl 6 API から Win 32 API へ移行する中で実現されてきた機能比較で 
ある0表では AP 〖別ではなく、プラットフォームとなる OS 別に機能を比較してい 
る0 
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機能 

3.1 

95 

NT 

32 ビット化 

B 

El 

■ 

自動八ードウエア認識 

B 

■ 

■ 

プラグアンドプレイ 

X 

■ 

x 

プリエンプティブ • マルチタスク 

ma 

■ 

■ 

Win 32 API 

mm 

■ 

■ 

Win 32s API 


El 


ネットワーク機能 

ma 

■ 

■ 

16 ビットアプリケーション間のクラッシュ保護 



■ 

セキュリティ 

ma 


■ 

システム自動復帰 


ma 

〇 

MS-DOS サボート 



△ 

コンソール API 


ma 

〇 

OpenGL サボート 


■ 

■ 

MS-DOS リアルモードドライバ利用 


■ 

X 

16 ビット Windows ドライバ利用 



El 

UNICODE 対応 

ma 

rai 

■ 

ディスク圧縮機能 


■ 


非 Intel CPU サボート 

ma 

ma 

■ 

マルチブ□セッサ • サボート 

ma 

ma 

■ 


注： WindowsNT は Version 3.51 


1.2.2 Winl 6 からの移行 


Winl 6 API と Win 32 API は、ほとんどの API で互換性が保たれている 0 既存の 
16ビットアブリケーシヨン資産 （Visual C ++ 1.0 、 Visual C ++ 1.5, Visual Basic 
2.0 など）はソースコードの改変をほとんど必、要とせず、32ビットアブリケーシヨ 
ン化できる0ただし、一部のメッセージや、関数の戻り値など細かな変更がされ 
ている部分が少なくない0このあたりには十分な注意が必要になる。詳細につい 
ては Win 32 SDK を参照されたい。もう1点、32ビットアプリケーションを開発す 
るためには当然32ビットコードを生成する開発環境が必要になる。これらが 
Visual C ++ 4. x もしくは Visual Basic 4. x ということになる 0 
32ビットプログラミングで開発者（アブリケーション利用者も）が受ける煅も 
大きな恩恵として、システムリソースや 64 KB セグメントの撤廃がある0 
次の表は Win 32 API で廃止もしくは拡張などの変更がなされた API およびメッ 
セージの一覧である。 
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1.2 Win32 API 


1 サボート 

API/ メッセージ 

備考 

拡張 

WndProc 

ウインドウプロシージャ WndProc 
(HWNDhwnd.UINTmsg.UINTwParam.UINTIPar 
am) を定義 

拡張 

wndproc 

ウインドウプ□シージャ WndProc 
(HWNDhwnd.UINTmsg.UINTwParam.UINTIPar 
am) を定義 

拡張 

Add 卜 ontResource 

ファイル名には、八ンドルではなく文字列を使 
用 

拡張 

EMJ3ETSEL 

wParam/IParam バッキング変更 

拡張 

EM 一 LINESCROLL 

wParam/IParam ノてッキング変更 

拡張 

EM 一 SETSEL 

wParam/IParam ノてッキング変更 

拡張 

GetClassWord 

Win32 で 32 ビットに拡張されている値には 
GetClassLong を使用 

拡張 

GetModuleUsage 

Win32 では常に 1 を戻す 

拡張 

GetWindowWord 

Win32 で 32 ビットに拡張されている値には 
GetWindowLong を使用 

拡張 

RemoveFontResource 

ファイル名には八ンドルでなく文字列を使用 

拡張 

SetClassWord 

Win32 で 32 ビットに拡張されている値には 
SetClassLong を使用 

拡張 

SetWindowWord 

Win32 で 32 ビットに拡張されている値には 
SetWindowLong を使用 

拡張 

WM.ACTIVATE 

wParam/IParam ノ（ッキング変更 

拡張 

WM_CHANGECBCHA 

IN 

wParam/IParam ノてッキング変更 

拡張 

WM 一 CHARTOITEM 

wParam/IParam パッキング変更 

拡張 

WM.COMMAND 

wParam/IParam パッキング変更 

拡張 

WM_DDE 一 ACK 

wParam/IParam ノ C ッキング変更 

拡張 

WM 一 DDE 一 ADVISE 

wParam/IParam/ C ッキング変更 

拡張 

WM_DDE_DATA 

wParam/IParam ノてッキング変更 

拡張 

WM_DDE_EXECUTE 

wParam/IParam ノてッキング変更 

拡張 

WM_DDE_POKE 

wParam/IParam ノ 〇ンキング変更 

拡張 

WM_HSCROLL 

wParam/IParam ノ C ッキング変更 

拡張 

WM_MDIACTIVATE 

wParam/IParam ノてッキング変更 

拡張 

WM_MDISETMENU 

wParam/IParam パッキング変更 

拡張 

WM 一 MENUCHAR 

wParam/IParam ノてッキング変更 

拡張 

WM.MENUSELECT 

wParam/IParam ノてッキング変更 

拡張 

WM_PARENTNOTIFY 

wParam/IParam ノてッキング変更 

拡張 

WM^VKEYTOITEM 

wParam/IParam ノてッキング変更 
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拡張 

WM_VSCROLL 

wParam/IParam ノ t ッキング変更 

置換 

WM.CTLCOLOR 

WM_CTLCOLORtype メ ッ セージで S 換。 

wParam/IParam ノ t ッキング変更 

廃止 

AccessResource 

Win32API には相当するものなし（リソース API 
で対応予定） 

廃止 

AllocDSToCSAIias 

Win32API には相当するものなし 

廃止 

AllocResource 

Win32API には相当するものなし（リソース API 
で対応予定） 

廃止 

AllocSelector 

Win32API には相当するものなし 

廃止 

ChangeSelector 

Win32API には相当するものなし • 

廃止 

CloseComm 

CloseFile で置換 

廃止 

CloseSound 

マルチメディアサウンドサポートで圈換 

廃止 

CountVoiceNotes 

マルチメディアサウンドサポートで B 換 

廃止 

DeviceCapabilities 

移植可能な DeviceCapabilitiesEx で置換 

廃止 

DeviceMode 

移植可能な DeviceModeEx で匾換 

廃止 

DlgDirSelect 

移植可能な DlgDirSelectEx で H 換 

廃止 

DlgDirSelectComboBox 

移植可能な DlgDirSelectComboBoxEx で圈換 

廃止 

D0S3Call 

名前付きの移植可能な Win32API で置換 

廃止 

ExtDeviceMode 

移植可能な ExtDeviceModeEx で匾換 

廃止 

FlushComm 

PurgeComm で B 換 

廃止 

FreeSelector 

Win32API には相当するものなし 

廃止 

GCW.CURSOR 

GetlSetClassCursor で置換 

廃止 

-- 

GCW HBRBACKGRO 

GetlSetClassBrBackground で通換 

UND 

廃止 

GCW.HICON 

GetlSetClassIcon で B 換 

廃止 

GetAspectRatioFilter 

移植可能な GetAspectRatioFilterEx で臛換 

廃止 

GetBitmapDimension 

移植可能な GetBitmapDimensionEx で置換 

廃止 

GetBrushOrg 

移植可能な GetBrushOrgEx で S 換 

廃止 

GetCodeHandle 

Win32API には相当するものなし 

廃止 

GetCodelnfo 

Win32API には相当するものなし 

廃止 

GetCommError 

GetCommState で88換 

廃止 

GetCurrentPDB 

Win32API には相当するものなし 

廃止 

GetCurrentPosition 

移植可能な GetCurrentPositionEx で S 換 

廃止 

GetEnvironment 

Win32API には相当するものなし 

廃止 

GetlnstanceData 

等価なものなし。 IPC メカニズムでサボート 

廃止 

GetKBCodePage 

Win32API には相当するものなし 
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サボート API / メッセージ 


廃止 

廃止 


廃止 


廃止 


廃止 


廃止 


廃止 

廃止 


廃止 


廃止 

廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 

廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


廃止 


GetMetaFileBits 


GetTempDrive 


GetTextExtent 


GetTextExtentEx 


GetThresholdEvent 


GetThresholdStatus 

GetViewportExt 


GetViewportOrg 

GetWindowExt 


GetWindowOrg 


GlobalDosAlloc 


GlobalDosFree 


GlobalPageLock 


GlobalPagellnlock 


HINSTANCE 



備考 


移植可能な GetMetaFileBitsEx で置換 


Win32 には適用されず 


移植可能な GetTextExtentPoint で置換 
移植可能な GetTextExtentExPoint で臛換 


マルチメディアサウンドサポートで置換 


マルチメディアサウンドサボートで證換 


移植可能な GetViewportExtEx で S 換 


移植可能な GetViewportOrgEx で B 換 


移植可能な GetWindowExtEx で H 換 


移植可能な GetWindowOrgEx で置換 


Win32API には相当するものなし 


Win32API には相当するものなし 


Win32API には相当するものなし 


Win32API には相当するものなし 


GWL—HINSTANCE で置換 




HWNDPARENT GWL_HWNDPARENT で置換 


GWLJD で圈換 


GWL_USERDATA で圏換 


Win32API には相当するものなし 


Win32 には相当するものなし 


移植可能な MoveToEx で置換 


名前付きの移植可能な Win32API で置換 


移植可能な OffsetViewportOrgEx で匾換 


移植可能な OffsetWindowOrgEx で S 換 


〇 penFile で匾換 


マルチメディアサウンドサポートで B 換 


Win32 プロフアイノレ文字列 API で置換 


Win32 プ□ファイル文字列 API で置換 


Win32 プ□ファイル文字列 API で匾換 


Win32 プ□ファイル文字列 API で置換 


Win32 プ□ファイル文字列 API で置換 


Win32 プ□ファイル文字列 API で置換 


JJSERDATA 


LimitEMSPages 


LocalNotify 


MoveTo 


NetBIOSCali 


〇 ffsetViewportOrg 


OffsetWindowOrg 


OpenComm 


〇 penSound 


ProfClear 


ProfFinish 


ProfFlush 


ProflnsChk 


ProfSampRate 


ProfSetup 
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廃止 

ProfStart 

Win32 プロフアイ;レ文字列 API で S 換 

廃止 

ProfStop 

Win32 プロフアイ)レ文字列 API で置換 

廃止 

ReadComm 

ReadFile で S 換 

廃止 

ScaleViewportExt 

移植可能な ScaleViewportExtEx で置換 

廃止 

ScaleWindowExt 

移植可能な ScaleWindowExtEx で B 換 

廃止 

SetBitmapDimension 

移植可能な SetBitmapDimensionEx で H 換 

廃止 

SetCommEventMask 

SetCommMask で匾換 

廃止 

SetEnvironment 

Win32API には相当するものなし 

廃止 

SetMetaFileBits 

移植可能な SetMetaFileBitsEx で臞換 

廃止 

SetResourceHandler 

Win32 には相当するものなし（リソース API で 
対応予定） 

廃止 

SetSoundNoise 

マルチメディアサウンドサポートで鼸換 

廃止 

SetViewportExt 

移植可能な SetViewportExtEx で B 換 

廃止 

SetViewportOrg 

移植可能な SetViewportOrgEx で匾換 

廃止 

SetVoiceAccent 

マルチメディアサウンドサポートで匾換 

廃止 

SetVoiceEnvelope 

マルチメディアサウンドサポートで匾換 

廃止 

SetVoiceNote 

マルチメディアサウンドサポートで臞換 

廃止 

SetVoiceQueueSize 

マルチメディアサウンドサポートで臞換 

廃止 

SetVoiceSound 

マルチメディアサウンドサポートで面換 

廃止 

SetVoiceThreshold 

マルチメディアサウンドサポートで臞換 

廃止 

SetWindowExt 

移植可能な SetWindowExtEx で！■換 

廃止 

SetWindowOrg 

移植可能な SetWindowOrgEx で臛換 

廃止 

StartSound 

マルチメディアサウンドサポートで鼸換 

廃止 

StopSound 

マルチメディアサウンドサボートで■換 

廃止 

SwitchStackBack 

Win32API には相当するものなし 

廃止 

SwitchStackTo 

Win32API には相当するものなし 

廃止 

SyncAIIVoices 

マルチメディアサウンドサポートで■換 

廃止 

UngetCommChar 

Win32 には相当するちのなし 

廃止 

ValidateCodeSegment 

s 

Win32API には相当するものなし 

廃止 

ValidateFreeSpaces 

Win32API には相当するものなし 

廃止 

WaitSoundState 

マルチメディアサウンドサポートで匾換 

廃止 

WriteComm 

WriteRle で臛換 
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1 .3 C++ からの Windows API 呼び出し 

Visual C++ において、 Win32 API は MFC (Microsoft Foundation Class Library) 
に隠蔽され、ほとんど API を呼び出す必要はない。というよりは、 API の呼び出し 
は極力避けて、可能な限り MFC で開発を進めることを勧める。 MFC は非常に完 
成度の高いクラスライブラリになっており、これを利用することで開発工数は以 
前に比べ少なく見植もることが口 J 能になる。しかし、残念なことに MFC だけでは 
どうにも処理できない機能を実装しなければならない場合も少なからずある。こ 
のような場合は API を直接呼び出さざるを得ない0 

Visual C++ での API 呼び出しは、いたって簡単である。必要なヘッダーファイ 
ルのインクルードと、ライブラリのインボートを定義するのみで API を直接呼び 
出せる。ヘッダーファイルとインポートすべきライブラリに関しては、 Visual 
C++ に付城する Win32 SDK の Win32 Reference を参照すれば解決できる。 

1.4 C からの Windows API 呼び出し 

C 言語でブログラムを作成する場合、 MS-DOS のブログラムでは main 関数が最 
初に実行される。 Windows では、 WinMain 閲数が用意されており、 Windows のシ 
ステムから最初に呼び出される。 

しかし、 Main 関数と WinMain 関数では動作はまったく異なっており、通常、 
WinMain では初期化処理とメッセージの交換を行う。実際の処理の記述は、 
RegisterClass API 関数で登録したメッセージの受け取り先の関数 (MainWndProc 
関数などと指定することが多い）に記述しなくてはならない。 

メッセージの受け取り先の関数では、 Windows のシステムより送られてくるメ 
ッセージの内容を判断して、対応した処理を記述する。次のブログラムはスケル 
トン（何もしない） Windows ブログラムの記述例である0実行するとウィンドウ 
が表示されるだけであるが、 Windows システムと実行したプログラムの間では 
様々なメッセージが飛び交っている。 

たとえば、ウィント/ウを作成した時点で WM_CREATE というメッセージが 
MainWndProc に送られてくる。表示されたウィンドウ上でマウスを動かすだけで 
も WMLMOUSEMOVE というメッセージが送られてくるのである。 

もちろん、すべてのメッセージに対して処理を記述する必要はない。必要なイ 
ベントに対応するメッセージに対してのみ処理を記述すればよいのである。ブロ 
グラムを終了しウインドウを破棄する時にのみ、必ず PostQuitMessage API 関数を 
呼び出さなくてはならない。 
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Win32 では hPrevInstance は常に NULL が返され、インスタンスは共有されずに 
多重起動する。 WinMain 関数の型は、 Winl6 では PASCAL 型であったが、 Win32 
では WINAPI 型に変更されている。 

MainWndProc などのコールバック関数は、将来の拡張の為に CALLBACK を使 
用することが推奨されるようになった。 

# include <wmdows .h> 

LRESULT CALLBACK MainWndProc (HWND, UINT, WPARAM, LPARAM) 

;/* ウインドウ関数*/ 


int WINAPI WinMain (hCurlnst, hPrevInst, lpCmdLine, iCmdShow) 
HANDLE hCurlnst ; /* 現在のインスタンス八ンドル*/ 


HANDLE hPrevInst ; 


LPSTR 



lpCrndbine ; 
iCmdShow ; 


/* 直前のインスタンス八ンドル V 
r コマンドラインのロングポインタ*/ 
/* ウィンドウの表示状態値*/ 


MSG msg ; 


/* メッセージ構造体*/ 


if (! hPrevInst) /* hPrevInst は常に NULL が返る*/ 

if ( ! InitApplication (hCurlnst)) I* ウインドウの登録*/ 
return (FALSE) ; /* 登録失敗ならば終了*/ 


if ( ! InitInstance (hCurlnst, 
return (FALSE); 


iCmdShow)) /* ウインドウの作成/表爪 V 
/* 作成失敗ならば終了*/ 


/* メッセーシ•ループ*/ 

while (GetMessage (&msg # 

NULL, 

NULL, 

NULL)) { 

TranslateMessage (&msg) ; 
DispatchMessage (&msg) ； 


/* メッセージの取得*/ 


/* メッセージの変換 ★/ 

/* メッセージのディスパッチ*/ 


return (msg.wParam) ； /* PostQuitMessage で設定された値を返し終了*/ 
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BOOL InitApplication (hCurlnst) 

HANDLE hCurlnst ; /* 現在のインスタンス*/ 

{ 

WNDCLASS wc ; /* ウインドウクラス構造体 V 


ハウインドウクラス構造体の設定*/ 


wc•style 
wc•lpfnWndProc 
wc.cbClsExtra 
wc.cbWndExtra 
wc.nlnstance 
wc.hlcon 

wc.hCursor 


=NULL ; /* クラススタイル V 

=MainWndProc ; / ★ウインドウ関数*/ 



/* 追加クラスデータ*/ 

/* 追加ウインドウデータ" 


= hCurlnst ; 


/* 現在のインスタンス*/ 


= Loadlcon (hCurlnst, ID し ICON) ; 

/* ウィンドウで使用するアイコン V 
= LoadCursor (NULL, IDC ARROW); 


ハウインドウで使用するカーソル*/ 


wc.hbrBackground = GetstockObj ect (black_BRUSH); 

ハ背祭となる色*/ 

wc•IpszMenuName = NULL ; /* メニユー名*/ 

wc •lpszClassName = "TDBWinWClass - ; /* ウインドウクラス名*/ 


ハウインドウクラスの登録*/ 


return (RegisterClass ^&wc)) 


* ウインドウクラス登録の結果を返す*/ 


BOOL Initlnstance (hCurlnst, iCmdShow) 
HANDLE hCurlnst ; /* 現在のインスタンス*/ 

int iCmdShow ; /* ウインドウの表示状態値*/ 


HWND hwnd ; /* 作成したメインウインドウの八ンドル V 


HDC hdc ； 


hlnst = hCurlnst ; /* 現在のインスタンスの保存*/ 


I ， ウインドウの作成*/ 

hwnd = CreateWindow v 

"TDBWinWClass" , / *RegisterClass で登録したウインドウクラス名*/ 

■TDB Sample app" , /* タイトルバーに表示する文字列*/ 

WS_OVERLAPPEDWINDOW # /* ウインドウスタイル*/ 

CW 一 USEDEFAULT • CW_USEDEFAULT # 

CW 一 USEDEFAULT • CW USEDEFAULT, 
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NULL, / ★親. オーナーの ウィンドウは無し*/ 

NULL, /* メニューは無し*/ 

hCurlnst, /* 現在のインスタンス*/ 

NULL / * ウィンドウ作成時の情報不要*/ 

) ； 

DeleteDC ( hdc) ; 

if ( ! hwnd) ハウィンドウは作成されたか？ V 

return (FALSE) ; /* 作成失敗ならば FALSE を返す V 

ShowWindow (hwnd , iCmdShow ) ； 

UpdateWindow (hwnd) ； 

return (TRUE) ; /* ウィンドウ作成成功を返す*/ 

} 

LRESULT CALLBACK MainWndProc (hwnd, message, wParam, lParam) 
HWND hwnd ; /* ウィンドウ八ンドル*/ 

UINT message ； /* メッセージ */ 

WPARAM wParam ； /* ワード値のメッセージ付加惝報*/ 

LPARAM lParam ； /* □ング値のメッセージ付加惝報 V 

{ 

switch (message) { /* メッセージの 判断 （ 32bit) */ 


case WM 一 CREATE: 
break ； 

case WM_DESTROY : /* ウィンドウ破棄のメッセージ V 

PostQuitMessage ( 〇 ) ； /*WinMan 関数のメッセージループを抜ける処理 

break ； 
derault ： 

return ^DefWindowProc (hwnd, message, wParam, lParam ))； 

) 

return (DefWindowProc (hwnd, message, wParam, lParam ))； 
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1.5 Visual Basic からの Windows API 呼び出し 


Visual Basic では、主要なイベントそれぞれにサブルーチンが自動的に付加され 
るような仕組みとなっている。たとえば、マウスでボタンをクリックした時に、 
何かをさせたいと思ったら、フォーム上にボタンを配置してクリックするだけで 
対応するサブルーチンが双れる。ここに Visual Basic のコードを記述すれば良い 0 


FileClick() FormLoad() 



Timer ilmer() 


TextChange() 


TextChange() 


Visual Basic において API の呼び出しを行うには、 3 段階の手続きが必要である。 


1* Declare による API の使用を宣言 

2 . 構造体の定義 

3. API の呼び出し 
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第 1 章 Windows アプリケーションと Win 32 API 


1 . 5.1 Declare による API の使用を宣言 


SUB プロシージャで API を利用する前に、 Declare ステートメントで API のイン 
ポートと、引数型の変換の宣言が必要になる 0 Declare ステートメントの定義例を 
示して解説する。 


Declare Function GetDeviceCaps Lib w gdi32 f, Alias "GetDeviceCaps" 
(ByVal hdc As Long, ByVal nIndex As Long) As Long 

上記ステ ー トメントにおいて、 GetDeviceCaps の部分が利用する API の閲数名 
である 0 " gdi 32" 部分は、 API の I 5 J ] 数 GetDeviceCaps が格納されている DLL 名であ 
る。 Windows のシステム API を呼び出す場合においては、 kemel 32. dll 、 gdi 32. dll 、 
user 32. dll ともに拡張子を除いた形で宣言する。その他のライブラリから API を呼 
び出すには、パスと拡張子（通常は. DLL ) を含めた形式で宣言する。 

Declare ステートメント後半の0内については引数の定義部分である 0 API は 
C 言語からの利用を前提に引数などが定義されているため 、 Visual Basic で利す 
るためには型変換が必要になる。次の表は主に利用される引数の型が C 言語と 
Visual Basic でどうのように対応しているかを表わしている 0 変数型については、 
ここに褐敕する以外にも多数存在する。詳細については [Windows SDKJ を参 
照してもらいたい。 

Declare ステートメント末尾の As 以下は、 API 関数の戻り侦の型を示している。 





NULL 

NULL 

As Any 

void 

戻り ■ 

一 

void へのポインタ 

void* 

As Any 

八ンドル 

hWnd.hDC.hMenu 

By Val 〜 As Integer 

構造体へのポインタ 

LPRECT 

〜 As Rect 

整数 

INT.UINT.WORD.BOOL 

By Val 〜 As Integer 

整数へのポインタ 

LPINT 

〜 As Integer 

整数配列へのポインタ 


〜 As Integer 

長整数 

DWORD.LONG 

By Val 〜 As Long 

長整数へのポインタ 

LPDWORD 

〜 As Long 

文字列へのポインタ 

LPSTR 

By Val 〜 As String 
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1.5 Visual Basic からの Windows API 呼び出し 


本#の「第2章 Win 32 API リファレンス」では 、 Visual Basic からでも利〗 IJ で 
きる API について、 Declare 宣言を併記している。また、本啓で取り扱っていない 
API については、 r \ Vin 32 SDKj や 『Visual Basic プロフェッショナル版 J 以上に 
添付の rAPi ビューヮー j を参照してもらいたい0 

1.5.2 構造体と定数の定義 


Declare ステートメントで使用する API の宣言を終えたら、 tflf 造体とパラメータ 
や戻り値として利用される定数値を定義する。 

構造体は Type ステートメント、定数は Const ステートメントを使いそれぞれの 
定義を行う。 

本#の「第2¢ Win 32 API リファレンス」で利用している構造体は「付録 C 
Visual Basic 用構造体一覧」に Type ステートメントを含めて揭极している。また、 
定数については「付録 D Visual Basic 用定数一览」に掲載している。本#で扱 
つていない構造体や定数については、 [ Win 32 SDKJ に添付されている 
•• windows . h ••のヘッダファイルを参照するか 、 『Visual Basic プロフェッショナル 
版』以上に添付の 『 API ビューワー J を参照してもらいたい。 

先の例を用いると、定数の宣言は次のようになる。 

Const HORZRES = 8 
Const VERTRES =10 


先の例では構造体を利用していないが、もし構造体を利用している API であれ 
ば、呼び出しの前に次のように構造体の定義を行う。もちろん、構造体の中でさ 
らに構造体へのポインタを参照している場合（次の例では MSG 構造体から 
POINTAPI 構造体を参照している）は、すべての構造体についての定義を行う。 


Type MSG 

hwnd As Long 
message As Long 
wParam As Long 
1Param As Long 
time As Long 
pt As POINTAPI 
End Type 


Type POINTAPI 
x As Long 
y As Long 
End Type 
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第 1 章 Windows アプリケーションと Win 32 API 


1.5.3 API の呼び出し 


Declare ステートメントでの宣言と、構造体や定数の定義を終えると、 API をユ 
ー ザ ー 定義のファンクションやサブプロシージャと同様に利用できる0例では、 
Declare ステ ー トメントは、 [ Form ] ウインドウのオブジェクト： （ General )， ブ 
ロシージャ： （ declarations ) に記述している 0 

Declare Function Get DeviceCaps Lib _gdi32_ Alias w GetDeviceCaps" 
(ByVal hdc As Long, ByVal nIndex As Long) As Long 

Sub Form 一 10 ad () 

Const HORZRES = 8 
Const VERTRES =10 
Show 

Print •現在の t ニタ解像度は •； 

Print GetDeviceCaps ( hDC, HORZRES ) ; _X ， ； 

Print GetDeviceCaps ( hDC, VERTRES );" ドットです 11 ; 

End Sub 


このサンブルでは、フ オームのロー ド時に AP 〖閲数 GetDeviceCaps を利用して、 
現在のモニタ解像度をフォーム上に表示している。 

Visual Basic での API 関数利用の際に注意しなければいけない点は API 関数の呼 
び出しをおこなう時に変数値のチエックなどがおこなわれな V 、点である。デバッ 
グやトレース作菜を進める時に注意したい。また取得したハンドルなどは忘れず 
に明示的な解放をする必要がある。 
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第 2 章 Win32 API リファレンス 



以降のリファレンスは、数千ある Win32 API の中からよく使われるであろ 
う300 API に絞り込み説明をしている。これら300の API は、下記のように 
機能ごとにまとめて掲載している。 

2.2 Window Management / ウインドウマネージメント 

Window, Caret, Clipboard, Common Dialog Box, Cursor, Icon, 

Message and Message Queue, Mouse Input, Painting and Drawing, 

Rectangle, Timers, Window Class, Window Property 

2.3 Window Controls/ ウインドウコント□ール 

Common Controls, Drag List Box, Property Sheet, Status Window 
Toolbar ， Up-Down Control ， Button，Combo Box, Dialog Box, 

Edit Control, List Box, Scroll Bar 

2.4 Shell Features / シェル 

Control Panel, File Installation Library, Screen Saver, 

Shell Library 

2.5 Graphic Device Interface/GDI インターフェイス 

Bitmap, Brush, Clipping, Color, Coordinate Space and Transformation, 

Device Context, Filled Shape，Font and Text, Metafile, Path 
Region 

2.6 System Service / システムサービス 

Accessibility，Data Decompression Library, Error, Rle, Help 
Memory Management, Pipe, Process and Thread, Registory, Resource 
String Manipulation, Structured Exception Handling, 

System Information, Time, Window Station and Desktop 

API 関数の機能別の一覧やアルファべット順一覧は、それぞれ「付録 A 機能別 API —覧」「付録 B 
アルファべット順 API—KJ にまとめた。 

本書で扱っていない API については fWin32 SDKJ (英語）を参照してもらいたい。 
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2.1 リファレンスの見方 


次に、リファレンスの見方を説明する0 


機能の鵑阜な肢明。 


VC ♦♦で API 関数を利用 
するための定義。 


API 間数名。| 


API 関 ft が格納されている DLL 名, 
VC ♦♦では特に参照する必*はない。 


VB で API 閣数を利用するた 
めの定義。オブジ I ク 
卜： { General ) のプロシージ 
ャ :( Declarations > に、この行 
をそのまま記述する。なお、 
VB から利用できない API は、 
この項目がない。 


パラメータに 抱定する僅の脱 
明。 VB では、 Declare 宜言の 
パラメータの 名前と興なる埸 
合がある。 この 埸合、 パラメ 
一夕を As の直前の変数名と 
»みかえること0また、 パラ 
メータが 構遒体の壜合は、付 
»C を#照し、構逢体の！:言 
も行うこと。报定する镅がリ 
テラル 僅 (MBJDK というよう 
な文字列)の壜合は、付 »D 
を参照し定数の定義を行う こ 
と0 


Icon 


機能分類。 


WindowsNT 3.51 で利用可能な API 閣数。| 


€螫列 


95で利用可能な APlWfiU 


HWND 


DccUrt HiocImmi Amofckoiuc W Ub 

hwod 


ドウハンドル 


<ByVAl h 


• Icomc W indMV 


Long » AsLodf 


/巧メ •夕 


ドウハンドル 


蒎*エウー情するには、 GetL^aEnorBIRtHHI する • 

讖ウ < ンドウ中のアイコン化されたすべてのウ < ンドウする • 

デスクトノブウ < ンドウのハンドル UGciDt^iopWmdcmrafttHW して取 W すん 

GdOrUiioD Window 


APlMtt の戻り僅の脱明。 


APIW 数の機能や注意事項 

などをまとめてある。 


間 a する他の api 間数や媾逢体 
などをまとめてある。本害で扱 
つて いるものについては 
•—•が付いている。それ以外に 
ついては 「 SDK 』 などを#照し 
てもらいたい。 


Viausl C++ ユーザーの方へ 


v B 以外の項目を参照してもらいたい。 API 関数とその周辺機能に関して知嫌を有する場合 
は、 VC の項目を参照するだけで十分その機能と用法が理解できるかと思われる。 

なお DLL 名は 、 Visual Basic ユーザーのためのものである。 VC++ から API 関数を呼び出す場合は、 
ヘッダファイルをインクルード (#include <windows.h>) するだけでよい 0 

詳細については、 VC++ に添付の 「Windows SDK オンラインヘルプ」を合わせて参照してほしい〇 


# Visual Basic ユーザーの方へ 

v c 以外の項目を参照してもらいたい。 VB から利用できない API は 、 v b の項目を記戧してい 
ない。 

パラメ-夕や 解脱 では、 VC の定義を元に説明を行っているので、パラメータ名が v B で定義した 
ものと異なる場合がある。 API 関数を呼び出す際のパラメータの数や順番は、 VC++/VB に違い 
はない 0 したがって、 パラメ - 夕のパラメータ名を、 Declare ステートメントで宣言したパラメータ 
名に読み換えていただきたい。 

特に注意すべき点は、パラメータに構造体が指定されている場合は「付録 C Visual Basic 用構造 
体定義 一 KJ を参照して、 Declare とともに Type の宣言もしなければならない。また、構造体の 
中で構造体を指定している場合もあるので、注意していただきたい。 

解説中のリテラル定数（ ” MB_YESNO" や " WM_CREATE” という文字列で表された定数）は「付録 
D Visua 旧 asic 用定数一覧」を参照していただきたい。プログラム中では、あらかじめ Public 
Const ステートメントで定数を定義し、パラメータに値を指定する埸合は、リテラル定数を用いる 
とより見やすいプログラムとなる。もちろん、定数を直接指定してもかまわない。 

Visual Basic のプロフェッショナル版、もしくはエンターブライズ版の方は、製品添付の 「 API ビ 
ユーア」を利用すると、 Declare 宣言や構造体の定義、定数の定義が楽にできるので本害と合わせ 
て利用するとよい。 
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第 2 章 Win32 API リファレンス 




2. 2 Window Management 

ウィンドウ マネージ メント 


ウィンドウのフレームをはじめとした基礎的な構成要素を操作するための API 
関数群がウィンドウマネージメント関数である。フレームウィンドウの作成か 
ら破棄、マウスやアイコン、ダイアログメッセージなどの処理を行うための必 
須関数群である。 


Window 



AdiustWindowRect 


ぐウサイズを変更する 


user 32 .dll 



NT 


V C 


V B 


パラメータ 


BOOL AdjustWindowRect ( 

LPRECT lprc y // 長方形の座標を示す RECT 構造体へのポインタ 

DWORD dwStyle ， //変換されるウィンドウのウィンドウスタイル 
BOOL /Menu //ウィンドウがメニューを持つかどうかを指定する 

)； 

Declare Function AdjustWindowRect Lib " user 32" Alias .. AdjustWindowRectA •’ （IpRect 
As RECT，ByVal dwStyle As Long , ByVal bMenu As Long ) As Long 

. i p rc クライアント長方形の座標を示す RECT 構造体へのポインタである。 

• dwStyle 変換されるクライアント長方形を含むウィンドウのウィンドウスタイル。 

W [总味 ___ 

WS_BORDER 境界を持つウィンドウ。 

WS CAPTION タイトルバーを持つウィンドウ（暗黙に WS_BORDER スタイルを持 

つ）。 WS.DLGFRAME スタイルと.紐に使うことはできない。 

WS^DLGFRAME 二 ffi 境界を持ち、タイトルを持たないウィンドウ。 

WS_HSCROLL 水平スクロールバーを持つウィンドウ0 

WS_THICKFRAME ウィンドウのサイズ変史に使うことができる、太を持つウィンドウ。 
WS VSCROLL 垂直スクロールバーを持つウインドウ0 


WS 一 DLGFRAME 
WS_HSCROL し 
WS.THICKFRAME 
WS VSCROLL 


• /Menu 


ウィンドウがメニューを持つ場合は TRUE を、持たない場合は FALSE を 
指定する。 
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2.2 ウインドウマネージメント 


戻り 値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー M 報を取得するには、 GetLastError 閲数を使う。 


解説 指定されたクライアント長方形のサイズに基づいて、ウィンドウ長方形に必要なサイ 

ズを計算する。このサイズを CreateWindovvl 対数に引き渡すことで目的のクライアン 
トサイズを持つウィンドウを作成する。 

Adjust WindowRect 関数は、クライアント領域のサイズを計算するとき、タイトルや 
境界の幅を考傲しない0タイトルや境界を持つウィンドウスタイルの場合、アプリケ 
ーションは AdjustWindowRect 関数を呼び出した後でそれらのサイズを加党する必要 
がある。メニューバーが複数行に折り返している埸合にも、2行目以降のサイズは考 
傲されない。 


参 照 


AdjustWindowRectEx.CreateWindowEx 


CreateWindow 

user32.dll 

95 

NT 

ウィンドウの作成 


V C 


V B 


HWND CreateWindow ( 

LPCTSTR IpszClassName ， 


LPCTSTR 

DWORD 

nt 

nt 

nt 

nt 

HWND 


HMENU 


Ipsz WindowName , 

dwStyle ， 

x 、 

y> 

n Width , 

nHeight , 

hwndParent ， 

hmenu . 


HANDLE hinst . 


LPVOID IpvParam ' 


// NULL で終わる文字列へのポインタ 
// NULL で終わる文字列へのポインタ 
//作成されるウィンドウのスタイル 
//初期状態でのウィンドウの x 座標の位蹬 
//初期状態でのウィンドウの y 座標の位置 
//ウィンドウの幅をデバイス単位で指定 
//ウィンドウの高さをデバイス単位で指定 
//作成されるウィンドウの親ウィンドウを 
識別するハンドル 

//ウィンドウスタイルに依存する子ウィン 
ドウ ID 

//ウィンドウに関連付けられているモジユー 
ルインスタンス 

// CREATESTRUCT 構造体を通じてウインド 
ウに渡される値を指すポインタ 


Declare Function CreateWindow Lib " user 32" Alias " CreateWindowA " (ByVal 
lpClassName As String，ByVal IpWindowName As String , ByVal dwStyle As Long , 
ByVal x As Long , ByVal y As Long , ByVal nWidlh As Long，ByVal nHeight As Long , 
ByVal hWndParent As Long，By Val hMenu As Long , By Val hlnstance As Long , 
IpParam As Any ) As Long 
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第 2 章 Win32 API リファレンス 


パラメータ 


• IpszClassName NULL で終わる义ネ列を指すポインタか、または整数アトムで 

ある。このパラメータがアトムの場合、以前の GlobalAddAtom 
関数の呼び出しによって作成されたグローバルアトムでなけれ 
ばならない。アトムは、 OxCOOO 未満の16ビット値で 、 Ipsz 
ClassName の ド位ワードになければならない。上位ワードは0に 
なる。が义字列を指す埸合、ウィンドウクラスの 
名前を指定する0クラス名には、 RegisterClass 閲数で登録され 
た名前や、定義済みのコントロールクラス名が指定できる0 

• IpstWindowName ウィンドウ名を表す NULL で終わる义7列を指すボインタである。 

- dwStyle 作成されるウィンドウのスタイルを指定する。指定できる値は、 

AjustWindowRect を参照。 

•ズ 初期状態でのウィンドウの x 座標の位 S5 を指定する。オーバー 

ラップウィンドウやポップアップウィンドウでは、ズパラメータ 
はウィンドウの左上隅の初期 x 座標になる。子ウィンドウでは、 
親ウィンドウのクライアント領域の左上隅に相対的な子ウィン 
ドウの左上隅の x 座標になる。この値に CWJJSEDEFAUUT を 
指定すると、 Windows はウィンドウの左上隅の位！ ff としてデフ 
ォルトの位趵を選択して、： y パラメータを無视する。 CWJJSE 
DEFAULT はオーバーラップウィンドウに対してだけ有効であ 
る。ポップアップウィンドウや子ウィンドウに対して CWJJSE 
DEFAULT を指定した埸合、ズパラメータと: y パラメータはとも 
に0に設定される。 

• y 初期状態でのウィンドウの y 座標の位蹬を指定する。オーバー 

ラップウィンドウやポップアップウィンドウでは、： y パラメータ 
はウィンドウの左上隅の初期 y 座標になる。子ウィンドウでは、 
親ウィンドウのクライアント領域内の左上隅に相対的な子ウィ 
ンドウの左上隅の初期 y 座標になる。リストボックスでは、親 
ウィンドウのクライアント領域の左上隅に相対的なリストボッ 
クスのクライアント領域の左上隅の初期 y 座標になる。オーバ 
ーラップウィンドウを WS_VISIBLE スタイルで作成してズパラ 
メー タを CWJJSEDEFAULT に設定した坳合、 Windows は .v パ 
ラメータを無視する。 

- nWidth ウィンドウの幅をデバイス琳位で指定する。オーバーラップウ 

ィンドウでは、パラメータはスクリーン座標単位でのウ 
ィンドウの幅、または CW_USEDEFAUUT になる。 nWidth が 
CW_USEDEFAULT のとき、 Windows はウィンドウに対してデ 
フォルトの幅と高さを選択する。デフォルトの幅は初期状態で 
の x 座標位 H からスクリーンの右端までの長さ、デフォルトの 
高さは初期状態での y 座標位置からアイコン領域の上端までの 
長さである。 CWJJSEDEFAULT はオーバーラップウィンドウ 
に対してだけ有効である。ポップアップウィンドウや子ウィン 
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2.2 ウインドウ マネージ メント 


戻り値 


解説 


• nHeight 


• hwndParent 


• nmenu 


• hinst 


• IpvParam 


ドウに対して CWJJSEDEFAULT を指定した場合、 nWidth と 
nHeight はともに0に設定される。 

ウィンドウの高さをデバイス単位で指定する。オーバーラップ 
ウィンドウでは、”//ど/#/パラメータはスクリーン座標単位での 
ウィンドウの高さになる。 A 2 VV / •心/2パラメータが CWJJSE 
DEFAULT に設定された場合、 Windows は nHeight を無視する。 
作成されるウィンドウの親ウィンドウまたはオーナーウィンド 
ウを識別する。子ウィンドウやオーナー付きウィンドウを作成 
するときには、有効なウィンドウハンドルを提供しなければな 
らない。子ウィンドウはその親ウィンドウのクライアント領域 
に鬨かれることになる。オーナー付きウィンドウとは、その才 
ーナーウィンドウが破衆されるときに破棄され、オーナーウィ 
ンドウがアイコン化されるときに非表示となるオーバーラップ 
ウィンドウのことで、帘にオーナーウィンドウの上に表示され 
る。このパラメータは、 AvStyfe パラメータが WSJTHILD スタ 
イルを含むときは有効なハンドルを指定しなければならないが、 
dvvSty/e が WS_POPUP スタイルを含むときには省略可能である。 
メニューの識別、またはウィンドウのスタイルに依存する子ウ 
ィンドウ ID を指定する。オーバーラップウィンドウまたはポッ 
プアップウインドウでは、ル似 Am パラメータはウインドウで使わ 
れるメニューを識別する。クラスメニューを使うときには NULL 
が指定できる。子ウィンドウの埸合には、子ウィンドウ ID で、 
親ウィンドウにイベントを通知するダイアログボックスコント 
ロールが使う整数値になる。子ウィンドウ ID はアプリケーショ 
ンにより決められ、同じ親ウィンドウを持つすべての子ウィン 
ドウに対して一怠でなければならない。 

そのウィンドウに閲連付けられているモジュールのインスタン 
スを識別する。 

WM_CREATE メッセージの//^;^ m パラメー タが参照する 
CREATESTRUCT 構造体を通じてウィンドウに渡される倘•を指 
すポインタである。アプリケーションが CreateWindow 閲数を呼 
び出してマルチドキュメントインターフェイス （ MDI ) のクラ 
イアントウィンドウを作成するときには、 IpvPamm パラ メータ 
は CLIENTCREATESTRUCT 構造体へのポインタでなければな 
らない。 


正常終了 ウインドウハンドル 

異常終了 NULL 

拡張エラー怡報を取 fU するには、 GetLastErrorlJy 数を利用する。 


オーバーラップウィンドウ、ポップアップウィンドウ、子ウィンドウを作成する。 
Create Window 関数は、ウインドウクラス、ウインドウタイトル、ウインドウスタイ 
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ル、ウィンドウの初期状態での位蹬とサイズを指定する。また、親ウィンドウまた 
はオーナーウィンドウ、およびメニューも指定可能である。 

Create Window 関数は、制御を戻す前に WM_CREATE メッセージをウィンドウプロ 
シージャに送る。 

参照 —► CreateDialog ’ CreateWindowEx ，— DialogBox ，— MessageBox ，— CREATESTRUCT , 

— CLIENTCRE ATESTRUCT 


DestroyWindow 

user32.dll 

95 

NT 

ウィンドウの破棄 


V C BOOL DestroyWindow ( 

HWND hwnd // 破棄されるウィンドウを識別する 

)； 


V B Declare Function DestroyWindow Lib M user 32" Alias ’’ DestroyWindow ” (ByVal hwnd 

As Long ) As Long 


パラメータ 

• hwnd 

破棄されるウィンドウを識別する。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怙報を取得するには、 GetLastError 閲数を利用する。 

解脱 指定されたウィンドウを破棄する。この関数は、 WM_DESTROY メッセージおよび 

WM_NCDESTROY メッセージをウィンドウに送ってウィンドウを非アクティブ化し、 
入カフォーカスを取り除く。また、この関数は、ウィンドウメニューの破棄、スレ 
ッドのメッセージキューのフラッシュ、タイマの破襲、クリップボードの所イ I 権の除 
去、クリップボードビューァチヱインの切断をそれぞれ実行する。 

スレッドは、 DestroyWindow 関数を使って、別のスレッドによって作成されたウィン 
ドウを破棄することはできない。破棄されるウィンドウが子ウィンドウで、 WS _ EX _ 
NOPARENTNOTIFY スタイルがセットされて、ないときは、 WM_PARENTNOTIFY 
メッセージが親ウィンドウに送られる。 

参 照 — CreateDialog，—Create Window ， CreateWindowEx ，— WM _ DESTROY ， 

—WM NCDESTROY 
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GetWindow 

user 32 .dll 

95 

NT 

ウインドウのハンドルの取得 


V C 


V B 

パラメータ 


BOOL GetWindow ( 

HWND hWnd , //ウィンドウハンドルを取得するために利用する I 対迚ウィ 

ンドウハンドル 

UINT uCmd /// iWm / パラメータで示されるウィンドウとの関係 

)； 

Declare Function GetWindow Lib " user 32" Alias " GetWindow " (ByVal hwnd As Long , 
By Val wCmd As Long ) As Long 

• hWnd ウィンドウハンドルを取得するために利用する関迚ウィンドウハンドル。 
- uCmd パラメータで示されるウィンドウとの閲係。 “ Om / パラメータには以下 
の値のいずれかを指定する。 




立味 


GW 一 CHILD 
GW HWNDFIRST 


GW HWND し AST 


W 前面にある子ウィンドウを識別するハンドルを取得する。 

M 上位ウィンドウを識別するハンドルを返す。指定されたウィ 
ンドウが子ウィンドウの坳合には兄弟ウィンドウのハンドルを 
返す。 

敁下位ウィンドウを識別するハンドルを返す。指定されたウィ 
ンドウが子ウィンドウの坳合には兄弟ウインドウのハンドルを 
返す。 


GW HWNDNEXT 


指定されたウィンドウの下位ウィンドウを满別するハンドルを 
返す。 W 上位ウィンドウが指定された合には指定されたウィ 
ンドウのハンドルを返す。子ウインドウが指定された坳合には 
兄弟ウィンドウのハンドルが返される。 


GW HWNDPREV 


GW OWNER 


指定されたウィンドウの上位ウィンドウを識別するハンドルを 
返す。 W 上位ウィンドウが指定された場合には指定されたウィ 
ンドウのハンドルを返す。子ウインドウが指定された坳介には 
兄弟ウィンドウのハンドルが返される。 

オーナーウィンドウを識別するウインドウハンドルを返す0 


戻り値 

正常終了 

ウインドウハンドル 


異常終了 

FALSE 


拡張エラー情報を取得するには、 GetLastEmn •関数を利用する。 

解説 指定されたウィンドウのウィンドウハンドルを取得する。 AWm / パラメータで指定さ 

れたウィンドウを基準に wCmJ パラメータの関係を満たす®初のウィンドウハンドル 
を検索する。 

参 照 GetActiveWindow , GetNextWindow,GetTopWindow 
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GetWindowRect 


95 

NT 

ウィンドウ全体のサイズを取得 


V C BOOL GetWindowRect ( 

HWND hWnd ， //ウィンドウのハンドル 

LPRECT IpRect // RECT 構造体へのポインタ 

)； 


パラメータ 

• hWnd 

ウィンドウを識別するハンドル。 


• IpRect 

ウィンドウの左上から右下コーナーのスクリーン座標を受け取る RECT 
構造体へのポインタ。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怙報は GetLastError 関数で取得する 0 
参 照 GetClientRect，—RECT 


GetWindowText 


95 

NT 

ウィンドウのタイトルを取得 


V C 


int GetWindowText ( 

HWND hWnd , 

LPTSTR IpString ， 
int nMaxCount 

)； 


// ウィンドウもしくはコント ロール オブジェクトの 

ハンドル 

//文字列を格納するバッファへのポインタ 
//受け取る文字列の敁大長 


パラメータ 

• hWnd ウィンドウもしくはコントロールオブジェクトのハンドルを指定する。 

• IpString テキストを格納するための NULL で終わる文字列へのポインタ。 

• nMaxCount IpString にコピーされるテキス トの W 大長を指定する 0 受け取った 

文字列がこの値よりも大き t ゝ埸合には切りつめられる。 

戻り値 

正常終了 

異常終了 

NULL で終わる文字を含まな t ゝ文字列の長さ 

0 


拡張エラ ー til •報は GetLastError 関数で取得する 0 


解説 この関数は、 WM_GETTEXT メッセージを指定されたウィンドウまたはコントロー 

ルに送る。この関数でエディットコントロールのテキストを取り出すことはできな 


参 照 GetWindowTextLength ，— SetWindowText ，— WM_GETTEXT 
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MoveWindow 

user 32 .dll 

95 

NT 

ウインドウのサイズと位置を変更 


v c BOOL MoveWindow ( 

HWND hWnd ， //ウィンドウを識別するハンドル 

int X ， //原点の X 座標 

int K ， //原点の Y 座標 

. int nWidfh ， //ウイン ドウの幅 

int nHeight y //ウィンドウの高さ 

BOOL bRepaint //再描画フラグ 

)； 


Declare Function MoveWindow Lib " user 32" Alias " MoveWindow " (ByVal hwnd As 
Long , ByVal x As Long , ByVal y As Long , ByVal nWidth As Long , ByVal nHeight As 
Long , ByVal bRepaint As Long ) As Long 


パラメータ 


• hWnd ウィンドウを識別するハンドルを指定する。 

• X ウィンドウの左上の X 座標を指定す る。 

- Y ウィンドウの左上の Y 座標を指定する。 

• nWidth ウィンドウの幅を指定する。 

• nHeight ウィンドウの高さを指定する。 

• bRepaint ウィンドウを再描画するかどうかを指定する。パラメータが TRUE の埸 

合、ウインドウは WM _ PA 1 NT メッセージを受け取る。パラメータが 
FALSE の埸合には、 I 、かなる再描画も実行されない。 


戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


解 脱 パラメータが TRUE の埸合には、 Windows はウィンドウを動かした_；後に 

WMJ^AINT メッセージを OS に送る（すなわち、 MoveWindow ファンクションコー 
ル Update Window 閲数）。が FALSE の埸合には 、 Windows は、 WM _ 
PAINT メッセージをウインドウと関述したメッセージキューに送る。 


参 照 


SetWindowPos ， UpdateWindow ，〜 WM _ GETM 1 NM AXINFO ，— WM_PAINT 
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SetWindowText 


，ンドウのタイトルやテキストを設定 


user 32 .dll 



NT 


V C BOOL SetWindowText ( 

HWND hWnd . // ウィンドウもしくはコントロールのハンドル 

LPCTSTR IpString //テキストを格納した NULL で終わる文字列へのポインタ 

)； 

V B Declare Function SetWindowText Lib " user 32" Alias " SetWindowTextA " (ByVal hwnd 

As Long，ByVal IpString As String ) As Long 

パラメータ • hWnd タイトルテキストを変史したいウィンドウのハンドルを指定する。 

• IpString テキストを格納した NULL で終わる文字列へのボィンタを指定する。 

戻り値 

拡張エラ_怙報は GetLastError 関数で取得する 0 

解脱 SetWindowText 関数は、 WM_SETTEXT メッセージを指定されたウィンドウもしくは 

コントロールに 送る。 SetWindowText 閲数はタブ文字を認識しない （ASCII コード 
0 x 09) 〇タブ文字は垂商のバー⑴文字として表示される。 



Caret 



CreateCaret 


ノッ トの作成 


user 32 .dll 

95 

NT 



HHHBH void CreateCaret ( 

HWND hwnd ， // 新しいキヤレットを所有するウィンドウハンドル 

HBITMAP hbmp , //キヤレットの形状を定義したビットマップハンドル 

int nWidth ， H キ ヤレットの幅を論理単位で指定 

int nHeight //キヤレットの高さを綸 PfHH 位で指定 

)； 

V B Declare Function CreateCaret Lib ’ user 32’’ Alias " CreateCaret " (ByVal hwnd As Long ， 

ByVal hBitmap As Long，ByVal nWidth As Long，ByVal nHeight As Long ) As Long 

パラ メータ . hwnd 新しいキヤレットを所有するウィンドウを識別する。 

• hbmp キヤレットの形状を定義したビットマップを識別する。このパラメータ 

が NULL の坳合にはキャレットは標準表示になり、1の埸合には灰色表 
示となる。 
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• nWidth キ ヤレッ トの幅を論理 単位で 指定する。この パラメータが NULL の埸 

合は、キヤレットの幅はシステム定義のウィンドウ境界の幅に設定さ 
れる〇 hbmp がビッ トマップのハンドルの場合、 CreateCaret はこのパラ 
メータを無視する。 

• "Height キヤレットの高さを論理単位で指定する。このパラメータが NULL の 

埸合は、キヤレットの高さはシステム定義のウィンドウ境界の萵さに 
設定され る 0 hbmp がビッ トマップのハンドルの埸合、 CreateCaret はこ 
の パラメータを 無視す る。 

戻り値 

拡張エラー怙報を取得するには、 GetLastError 間数を利用する。 

解脱 システムキヤレットの形状を新たに作成し、指定されたウィンドウにそのキヤレット 

の所有権を与える。キヤレットの形状は、線やブロック、またはビットマップにする 
ことが可能である。 

nWidth パラメータと nHeight パ ラメータは、キヤレットの!！* M と高さを論理中.位で衍定 
するが、正確な幅と萵さは、ウィンドウのマッピングモードに依存する。 

参 职 — CreateBitmap ,— CreateDIBitmap ， DestroyCaret ，— GetSystemMetrics ’ HideCaret ， 

— LoadBitmap.ShowCaret 




GetCaretPos 


y 、、 j 卜の現在位置を取得 


user 32 .dll 



NT 



V C BOOL GetCaretPos ( 

LPPOINT IpPoint // クライアント座標を受け取る POINT 構造体への 

ポインタ 

)； 

V B Declare Function GetCaretPos Lib " user 32" Alias " GetCaretPos " (IpPoint As 

POINTAFI ) As Long 

パラメータ • IpPoint キヤレッ トの現在位蹬を受け取る POINT 構造体へのボイ ンタ〇 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー情報を取得するには、 GetLastError 関数を利用する。 

解脱 クライアント座標で示されたキヤレットの現在の位 S を、指定された POINT 構造体 

にコピーする。キヤレットの位置は、常にキヤレットのあるウインドウのクライアン 
卜座標として与えられる。 


参 照 


SetCaretPos ，— POINT 
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HideCaret 

指定されたウインドウからキ 




ットを削除 


v a c BOOL HideCaret ( 

HWND hWnd //ウィンドウを識別するハンドル 


V B Declare Function HideCaret Lib " user 32" Alias " HideCaret " (ByVal hwnd As Long ) As 



Long 


パラメータ 

• hWnd 

キャレットを削除するウィンドウを識別するハンドル。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怡報を取得するには、 GetLastError 関数を利用する。 

解脱 指定されたウィンドウがキヤレットを所有している場合には、 HideCaret はキヤレッ 

卜を隠す。指定されたウィンドウがキヤレットを所有していない場合には 、 HideCaret 
№1数は何もせず、 FALSE を戻す。 

HideCaret 関数が5回呼ばれた埸合には、再度キヤレットを表示するために ShowCaret 
関数を5回呼ばなければならない。 

参 照 —► CreateCaret ’ DestroyCaret ，— GetCaretPos , SetCaretPos,ShowCaret 


Bi— —b 、 




クリップ ボードをクローズ 


V C BOOL CloseClipboard (); 


Declare Function CloseClipboard Lib " user 32" Alias ’’ CloseClipboard’（）As Long 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怡報を取得するには、 GetLastErroi •間数を利用する。 

解税 クリップボードをクローズする。 

ウィンドウがクリ ップ ボードの 参照または変更を終了したときには 、 CloseClipboard 
_数を呼び出すことで クリ ップ ボー ドを クローズし なければならない。これにより、 
ほかのアプリケーションがクリップボー ドに アクセス 可能となる。 

参 照 
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EmptyClipboard 

user 32 .dll 

95 

NT 

クリップボードを空にする 


V C BOOL EmptyClipboard () ; 


V B Declare Function EmptyClipboard Lib ” user 32” Alias ’ EmptyClipboard’’（）As Long 


戻り傕 

正常終了 

TRUE 


與常終了 

FALSE 


拡張エラー怡報を取得するには、 GetLastError _数を利用する。 

解脱 クリップボードの内容を空にし、クリップボード内のデータを識別するハンドルを解 

放する。そして、現在クリップボードをオープンしているウィンドウに、クリップボ 
ードの所有権を与える。 

アプリケーションは、 EmptyClipboard 閲数を呼び出す前に OpenClipboard 閲数を使つ 
てクリップボードをオープンしなければならない。クリップボードをオープンすると 
きにアプリケーションが NULL のウィンドウハンドルを指定する坳合、 
EmptyClipboard 閲数は正常に終了するが、クリップボードのオーナーは NULL に設定 
される。 

参 照 OpenClipboard ’ SetClipboardData，—WM 一 DESTROYCLIPBOARD 


GetClipboardData 

user 32 .dll 

95 

NT 

クリップポードデータの取得 


V C HANDLE GetClipboardData ( 

UINT uFormat // クリップボード形式 

)； 


V B Declare Function GetClipboardData Lib " user 32" Alias ' GetClipboardDataA '' (ByVal 

wFormat As Long ) As Long 


パラメータ 

• utormat 

クリップボード形式を指定する。 

戻り値 

正常終了 

異常終了 

クリ ップ ボードオブジェクトへのハンドル 

NULL 


拡張エラー情報を取得するには、 GetLastErroi •関数を利用する。 

解脱 指定された形式を持つクリップボードのデータを取得する。クリップボードはあらか 

じめオープンされて t ゝなければならない。 

EnumClipboardFormats 関数を使用して、あらかじめ有効なデータ形式を列學してお 
くことも可能である。 

参 照 EnumClipboardFormats,SetClipboardData 
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enClipboard 


クリップボードをオープンする 


user 32 .dll 



V C BOOL OpenClipboard ( 

HWND び//ウインドウを識別するハンドル 

)； 

V B Declare Function OpenClipboard Lib " user 32" Alias " OpenClipboard " (ByVal hwnd As 

Long ) As Long 

パフメータ • h WndNewOwner 才ープンするクリップボードと結び付けられるウィンドウを 

識別する ハン ドルを指定する 0パラメータに NULL を指定す 
ると、現在のタスクとクリップポードが結び付けられる。 

戻り値 

拡張エラー怡報を取得するには、 GetLastError 関数を利用する。 

解説 別のウィンドウがクリップボードを所有している場合には、 OpenClipboard 関数は失 

敗する。アプリケーションは、必ず CloseClipboard 関数でオープンしたクリップボー 
ドを閉じる必要がある。 

赛 照 — CloseClipboard ，— EmptyClipboard 



Common Dialoa Box 


ChooseColor 


色選択のダイアログを作成 


comdlg 32 .dll 



V C BOOL ChooseColor ( 

LPCHOOSECOLOR Ipcc //CHOOSECOLOR 構造体へのポインタ 

)； 

V B Declare Function ChooseColor Lib M comdlg 32. dll •’ Alias " ChooseColorA " (pChoose 

color As CHOOSECOLOR ) As Long 
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パラメータ • Ipcc 呼び出し時は、ダイアログボックスを初期化するために必驳な情報を格 

納する CHOOSECOLOR 構造体へのボインタである。 ChooseColor 関数が 
制御を炭すときは、この構造体にユーザーが選択した色に関する怙報が 
格納される。 

戻り値 ユーザーが色を選択した坳合 [true 

それ以外の埸合 FALSE 

解説 ユーザーが色を遼択できるシステム定義のダイアログボックスを作成する。 

このダイアログボックスでは、カラーパレットをサポートしない。ダイアログボック 
スが提供する色の選択肢は、システムカラーと、システムカラーのディザカラーに限 
られる。 

擊 照 CommDIgExtendedError ，— WM_CTLCOLORDLG 


ChooseFont 

comdlg 32 .dll 

95 

NT 

フォント選択のダイアログを作成 


V C BOOL ChooseFont ( 

LPCHOOSEFONT Ipcf // CHOOSEFONT 構造体へのポインタ 

)； 


Declare Function ChooseFont Lib M comdlg 32. dU M Alias H ChooseFomA M (pChoosefont 
As CHOOSEFONT ) As Long 


パラメータ 

參 Ipcf 

呼び出し時は、ダイアログボックスを初期化するために必要な怡報を格納 
する CHOOSEFONT 構造体へのボインタである 0 ChooseFont が制御を戻す 
ときには、この構造体にユーザーが選択したフォントに関する情報が格納 
される。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


解説 ユーザーがフォントを逭択できるシステム定義のダイアログボックスを作成する。 

フック関数が WM_CTLCOLORDLG メッセージを処理する場合、コントロールの背 
货を描画するために使われるブラシのハンドルを返さなければならない。 


参 照 CommDlgExtendedError ’ WM 一 CHOOSEFONT 一 GETLOGFONT ， 

WM CTLCOLORDLG，—CHOOSEFONT 
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FindText 

comdlg 32 .dll 

95 

NT 

テキスト検索のダイアログを作成 


V C 


V B 

パラメータ 


戻り値 


解説 


參 照 


HWND FindText( 

LPFINDREPLACE Ipfr // 初期設定データを格納した F1NDREPLACE 構造 

体へのポインタ 


)； 


Declare Function FindText Lib ’’comdlg32.dir Alias "FindTextA (pFindreplace As 
FINDREPLACE) As Long 


•Ipfr ダイアログボックス を初期 , 设定する FINDREPLACE 榊造 体へのポインタ 

を指定する。 


正帘終了 ダイアログボックスのウィンドウハンドル 

輿常終了 NULL 

拡張 エラー 報は GetLastError で 取得する。 GetLastError 閲数 ( む欠の M を返す 0 


CDERR 一 FINDRESFAILURE，CDERR 一 INITIALIZATION ， 

CDERR 一 LOCKRESFAILURE’CDERR 一 LOADRESFA1LURE ， 

CDERR—LOADSTRFAILURE ， CDERR_MEMALLOCFAILURE ， 

CDERR 一 MEMLOCKFAILURE’CDERR 一 NOHINSTANCE’CDERR 一 NOHOOK ， 
CDERR 一 NOTEMPLATE’CDERR 一 STRUCTSIZE ， FRERR-BUFFERLENGTHZERO 

FindText 関数は検索操作は実行しない。 

アプリケーションは、呼び出し時に RegisterWindowMessage 関数に 「 commdlg_ 
FindReplaceJ ストリングを指定し、識別子をこれらのメッセージに登録できる。 

CommDlgExtendedError ， —FlNDREPLACE ， IsDialogMessage ， RegisterWindowMessage ， 
— ReplaceText，— WM_CTLCOLORDLG ， 
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GetFileTitle 

comdlg 32 .dll 

95 

NT 

ファイル名を取得 


V C 


short GetFileTitle( 

LPCTSTR IpszFile ， // フルパス名を格納する文字列へのポインタ 
LPTSTR IpszTitle ， II フ了イ ル名を受け取るための文字列へのポインタ 
WORD cbBuf //ファイル名を受け取るバッファのサイズ 


V B Declare Function GctFileTitle Lib "comdlg32.dll" Alias "GetFileTitleA" (ByVal IpszFile 

As String，ByVal IpszTitle As String，ByVal cbBuf As Integer) As Integer 

パラメータ • IpszFile ファイルのフルパス名を指定する文字列へのポインタ。 

• IpszTitle ファイル名を格納するための文字列へのボインタ。 

• cbBuf /p 私 77/fe に格納されるファイル名のバッファサイズを衍定する。 


戻り値 

正常終了 

0 


ファイル名が無効 

負の整数 


/pszTMe の破が小 さい 

正の整数 


解 説 IpszFile パラメ ータが次の文字列の場合には、 GetFileTitlelW 数はエラーを返す。 

• 空の文字列 

• 「*」，「[」，「】」のいずれかの文字が含まれる埸合 
• 「:」，「/」，「\」のいずれかの文字で終わる場合 

• d^M/ で指定されたサイズよりも返されるファイル名の文字列が大き t ゝ埸合 
• 不正な文字が指定された埸合 

バッファサイズには NULL で終わる文字列を含む長さを指定する。 

参 照 —GetOpenFileName，—GetSaveFileName 


GetOpenFileName 

comdlg 32 .dll 

95 

NT 

ファイルを開くダイアログボックスの作成 


V C 


V B 


パラメータ 


BOOL GetOpenFileName( 

LPOPENHLENAME Ipofh 

)； 


// ダイアログボックス初期化用の OPEN 
FILENAME 構造体へのポインタ 


Declare Function GetOpenFileName Lib "comdlg32.dll" Alias "GetOpenFileNameA” 
(pOpenfilename As 0PENF1LENAME) As Long 

• Ipofn ダイアログボックス初期化用の OPENFILENAME 構造体へのボインタを 

指定する。 
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戻り値 

ユーザーがファ イルを遂択 

TRUE 


それ以外 

FALSE 


拡張エラー情報は CommDIgExtendedError で取 ftf する 0 CommDlgExtendedError は次 
のコードのいずれかを返す。 

CDERR_FINDRESFAILURE,CDERR_INITIALIZATION, 

CDERR 一し OCKRESFAILURE，CDERR 一し OADRESFAILURE ， 

CDERR 一 LOADSTRFAILURE ， CDERR 一 MEMALLOCFAILURE ， 
CDERR_MEMLOCKFAlLURE，CDERR 一 NOHINSTANCE，CDERR 一 NOHOOK ， 
CDERR 一 NOTEMPLATE ， CDERR 一 STRUCTSIZE’FNERR 一 BUFFERTOOSMAL し， 
FNERR_INVALIDFILENAME,FNERR_SUBCLASSFAILURE 

解脱 フック関数 （ OPENHLENAME 構造体の lpfnHook メンバによって示される）が、 

WM_CTLCOLORBTN , WM_CTLCOLORDLG > V/M—CT し COLORUSTBOX 、 
WM_CTLCOLORMSGBOX 、 WM_CTLCOLORSCROLLB AR 、または 
WM.CTLCOLORSTATIC メッセージを処理する坳合、 GetOpenFileName はコントロ 
ール背贵を塗りつぶすために使用されるブラシのハンドルを戻さなければならない。 

参 照 CommDlgExtendedError，— EndDialog ， —GetSaveFileName，— OPENFILEN AME 


GetSaveFileName 

comdlg 32 .dll 

95 

NT 

名前を付けて保存のダイアログボックスを作成 


V 

C 

BOOL GetSaveFileName( 




LPOPENFILENAME 

)； 

Ipofn //OPENFILENAME 構造体へのポインタ 

V 

B 

Declare Function GetSaveFileName Lib ,, comdlg32.dll M Alias "GetSaveFileNameA 



(pOpenfilename As OPENFILENAME) As Long 

• Ipofii ダイアログボックス初期化用の OPENFILENAME 構造体へのポインタを 

指定する。 

ハフメ 

ータ 

戻り 

値 

ユーザーが ファイルを保存 

TRUE 



それ以外 

FALSE 


拡張エラ _ 怡報は CommDlgExtendedError で取得する 0 CommDlgExtendedError は次 
のコードのいずれかを返す。 


CDERR_FINDRESFAILURE t CDERR_INITIALIZATION,CDERR_LOCKRES 
FAILURE,CDERR_LOADRESFAILURE,CDERR_LOADSTRFAILURE, 
CDERR_MEMALLOCFAILURE，CDERR 一 MEMLOCKFAILURE ， 

CDERR NOHINSTANCE,CDERR NOHOOK ， CDERR_NOTEMPLATE ， 
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CDERR 一 STRUCTSIZE ， FNERR_BUFFERTOOSMAL し， 

FNERR—INVAUDFILENAME ， FNERR_SUBCLASSFA1LURE 

解説 フック関数 （ OPENFILENAME 構造体の lpfnHook メンバによって示される）が、 

WM_CTLCOLORBTN 、 WM_CTLCOLORDLG 、 WM_CTLCOLORLISTBOX 、 
WM_CTLCOLORMSGBOX 、 WM_CTLCOLORSCROLLBAR 、 または WM_ 
CTLCOLORSTATIC メッセージを処理する埸合、 GetOpenFileName はコントロール 
背景を塗りつぶすために使用されるブラシのハンドルを戻さなければならない。 

参 照 CommDlgExtendedError，— GetOpenFilename，— OPENFILEN AME ， 

—WM CTLCOLORDLG 


PaqeSetu 



ページ設定のダイアログボックスを作成 


comdla 32 .dll 



NT 



V C BOOL PageSetupDlg( 

LPPAGESETUPDLG Ippsd //PAGESETUPDLG 構造体へのポインタ 

)； 

V B Declare Function PageSetupDlg Lib ’comdlg32.dll’’ Alias "PageSetupDlgA” (pPage 

setupdlg As PAGESETUPDLG) As Long 

パラメータ • i pps( i ダイアログボックス初期化 HJ の PAGESETUPDLG 構造体へのボインタを 

指定する。ダイアログボックスを初期設定する F1NDREPLACE 構造体へ 
のポインタを指定する。 

戻り値 ページ铋性を設定変更した埸合 TRUE 

それ以外 FALSE 

拡張エラー情報は CommDlgExtendedError で取得する 0 

事 照 CommDIgExtendedError，— PAGESETUPDLG 
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PrintDI 


印刷ダイアログボックスを作成 


comdlq 32 .dll 



NT 


V C 


パラメータ 


戻り値 


解脱 


BOOL PrintDlg( 

LPPRINTDLG Ippd 

)； 


//PR1NTDLG 構造体へのポインタ 


Declare Function PrintDlg Lib "comdlg32.dll" Alias •PrintDlgA' (pPrintdlg As 
PRINTDLG) As Long 

•Ippd ダイアログボックス初期化用の PRINTDLG 構造体へのポインタを指定す 

る。 

ダイアログボックスが OK ボタンにより正常に終了 "! TRUE 
それ以外 FALSE 

彼張エラー借報は CommDlgExtendedError で取得する。 CommDlgExtendedError は次 
のコードのいずれかを返す。 

CDERR_FINDRESFAILURE,CDERRJNITIALIZATION, 

CDERRJX)ADRESFAILURE ， CDERR_LOADSTRFAlLURE ， 

CDERR 一 LOCKRESFAlLURE ， CDERR 一 MEMALLOCFAILURE ， 

CDERR 一 MEML0CKFA1LURE，CDERR 一 NOHINSTANCE，CDERR 一 NOHOOK ， 
CDERR_NOTEMPLATE，CDERR 一 STRUCTSIZE ， PDERR_CREATEICFAILURE ， 
PDERR_DEFAULTDIFFERENT,PDERR_DNDMMISMATCH, 
PDERR_GETDEVMODEFAIUPDERR_INITFAILURE,PDERR_LOADDRVFAILURE, 
PDERR_NODEFAULTPRN ， PDERR__NODEVICES，PDERR 一 PARSEFA1LURE ， 
PDERR PRINTERNOTFOUND^PDERR.RETDEFFAILURE 


フック関数 （ PRINTDLG 構造体の lpfnPrintHook メンバによって示される）ガ 
WM—CTLCOLORDLG メッセージを処理する坳合、 GetOpenFileName はコントロ， 
ル背景を途りつぶすために使用されるブラシのハンドルを戻さなければならない。 


CommDlgExtendedError ， —CreateDC’DOCINFO，— PRINTDLG,StartDoc, 
—WM CTLCOLORDLG 
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2.2 



ンドウマネージメン 


lacelext _ 


キストの置換ダイアログボックスの作成 


comdlg 32 .dll 



■HBBSBi HWND ReplaceText( 

LPFINDREPLACE Ipfr //FINDREPLACE 構造体へのポインタ 

)； 

V B Declare Function ReplaceText Lib "comdlg32.dll" Alias "ReplaceTextA" (pFindreplace 

As FINDREPLACE) As Long 

パラメータ • l p f r ダイアログボックス初期化用の FINDREPLACE 構造体へのボインタを 

指定する。 

戻り値 正常終了 \ H 換ダイアログボックスのウィンドウハンドル 

異常終了 NULL 

拡張エラー价報は CommDlgExtendedErrorlJy 数で取价する 。 CommDlgExtendedError 
関数は次のコードを返す。 


CDERR 一 FINDRESFAlLURE ， CDERR_INmALIZAT10N ， 
CDERR_LOADRESFAILURE，CDERR 一 LOADSTRFAILURE ， 
CDERR_LOCKRESFAILURE,CDERR_MEMALLOCFAILURE, 
CDERR_MEMLOCKFAILURE ， CDERR_NOHINSTANCE，CDERR 一 NOHOOK ， 
CDERR_NOTEMPLATE,CDERR_STRUCTSIZE,FRERR_BUFFERLENGTHZERO 

解説 ReplaceText 関数では、突際に蹬換は行わない 0 

アプリケーションは、呼び出し時に RegisterWindowMessage 関数に「 commdlg 一 
FindReplace 」 ストリングを指定して識別子をこれらのメッセージに登録できる。 

参 照 CommDlgExtendedError ， —FINDREPLACE ， IsDialogMessage ， RegisterWindowMessage ， 

—WM CTLCOLORDLG 
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CreateCursor 

user 32 .dll 

95 

NT 

マウスカーソルの 作成 


HCURSOR CreateCursor ( 


HINSTANCE 

hinst ， 

// マウスカーソルを作成するアプリケーシヨン 
のインスタンス 

int 

xHotSpot, 

//マウスカーソルのホットスポットの水平位趵 

int 

yHotSpot ， 

//マウスカーソルのホットスポットの垂直位骹 

int 

nWidth, 

//マウスカーソルの幅をピクセル琳位で指定 

int 

nHeight, 

//マウスカーソルの高さをピクセル単位で指定 

CONST VOID 

*pvANDplane y 

// マウスカーソル AND マスク用ビット値を表 
すバイト配列へのボインタ 

CONST VOID 

^pvXORplane 

// マウスカーソル XOR マスク用ビット値を表 
すバイト«列へのポインタ 


)； 


V B 


パラメータ 


Declare Function CreateCursor Lib M user32" Alias "CreateCursor" (ByVal hlnstance As 
Long，ByVal nXhotspot As Long，ByVal nYhotspot As Long，ByVal nWidth As Long ， 
ByVal nHeight As Long，IpANDbitPlane As Any，lpXORbitPlane As Any) As Long 

• hinst マウスカーソルを作成するアプリケーシヨンの現在のインスタンスを 

識別する。 

• xHotSpot マウスカーソルのホットスポットの水平位 5? を指定する。 

• yHotSpot マウスカーソルのホットスポットの垂直位 K を指定する。 

• nV/idth マウスカーソルの幅をピクセル単位で指定する。 

• nHeight マウスカーソルの高さをピクセル単位で指定する。 

• pvANDplcme マウスカーソルの AND マスク W のビッ ト値を表すバイト K 列を指す 

ボインタ。これはデバイスに依存するモノクロビットマップでのビッ 
トマスク。 

.pvXORplane マウスカーソルの XOR マスク用のビット値を表すバイト配列を指すポ 

インタ。これはデバイスに依存するモノクロビットマップでのビット 
マスク。 


戻り傕 

正常終了 

マウスカーソルのハンドル 


異常終了 

NULL 


拡張エラー怡報を取得するには 、 GetLastEmn •関数を利用する。 
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解説 指定されたサイズ、ビットパターン、およびホットスポットを持つマウスカーソルを 

作成する。 nWidth パラメータと nHeight パラメータには 、現在のディスプレイドライ 
バがサポートする幅と高さを指定しなければならない。これはシステムがほかのサイ 
ズの マウスカー ソルを作成できな I ゝためである。 

参 照 CreateIcon ， DestroyCursor ， GetModuleHandle ， —GetSystemMetrics，SetCursor 


GetCursorPos 

user 32 .dll 

95 

NT 

カーソルの現在のスクリーン座標の取得 


V C BOOL GetCursorPos ( 

LFPOINT IpPoinl //POINT 構造体へのポインタ 

)； 

v B Declare Function GetCursorPos Lib "user32” Alias ’GetCursorPos” (IpPoint As 

POINTAPI) As Long 

パラメータ • IpPoint カーソル位置をスクリーン座標で受け取る POINT 構造体へのボインタで 

ある。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー情報を取得するには、 GetLastError 関数を利用する。 


解説 カーソルの現在の位置のスクリーン座標を取得する。 

カーソルの位置は常にスクリーン座標で与えられる。カーソルが表示されているウイ 
ンドウのマッピングモードには関係がない。呼び出し側プロセスは、ウインドウステ 
ーシヨンへの WINSTA_READATTRIBUTES アクセスを持って t ゝなければならない。 

参 照 ClipCursor ， SetCursor ， SetCursorPos ， ShowCursor，— POINT 


LoadCursor 

user 32 .dll 

95 

NT 

リソースからマウスカーソルをロード 


v C HCURSOR LoadCursor( 

HINSTANCE hfnstance ， // アプリケーションのインスタンスを識別する 

ハンドル 

LFCTSTR IpCursorName //カーソルリソースの識別子 

)； 

V B Declare Function LoadCursor Lib ,, user32" Alias "LoadCursorA” (BvVal hlnstance As 

Long, ByVal IpCursorName As String) As Long 
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パラメータ 


戻り値 


解脱 


参 照 


• hlnstance ロー ドするカーソルリソースを含む実行可能ファイルのインスタ 

ンスを識別するハンドルを指定する。 

• IpCursorNante 口 ー ドする力ーソルリソースを識別する NULL で私 わる义 ’列へ 

のポインタ。 Win32 ではあらかじめ予約された次の値を指定す 

ることもできる。 


fct 

意味 

IDC_APPSTARTING 

標啷の矢印と小さな砂時計 

IDC.ARROW 

樣準の矢印 

IDC_CROSS 

クロスヘアカーソル 

IDCJBEAM 

1 ビームカーソル 

IDCJCON 

WindowsNT : Empty アイコン 

IDC_NO 

スラッシュ 付き円 

IDC.S1ZE 

WindowsNT : 4 方向矢印 

IDC.SIZEALL 

4 方向矢印 

IDC.SIZENESW 

右上 • 左下闽向き矢印 

1DC.SIZENS 

上下両向き矢印 

IDC 一 S1ZENWSE 

左上 • 右下 1 询向き矢印 

IDC_SIZEWE 

左右_向き矢印 

1DCJJPARROW 

上向き矢印 

IDC.WAIT 

砂時計 


正常終了 ロー ドされた カーソルのハン ドル 

異常終了 NULL 

拡張エラー情報は GetLastError 関数で取 fU する。 

IpCursorNante が力 ーソル （アイコンなと） を 除^ 、た ほかの リソースタイプを 指 し 
て も、 戻り 値は NULL とならない。 LoadCursor 機能は、現在の ディスプレイに 適 
なカーソルリソースを 捜す。 カーソルはカラーまたはモノクロのビットマップである。 

— Loadlmage，— M AKEINTRESOURCE，SetCursor，SetCursorPos，— ShowCursor 
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LoadCursori-romFile 


カーソルをロード 


user 32 .dll 



NT 




V C HCURSOR LoadCursorFromFile ( 

LPCTSTR IpFileName // カーソルファイルもしくはシステムカーソル 

)； 

v B Declare Function LoadCursorFromFile Lib M user32" Alias "LoadCursorFromFileA” 

(ByVal IpFileName As String) As Long 

パラメータ • IpFileName .CUR もしくは. ANI の拡張子で衣されるカーソルファイルを指定する 

NULL で終わる文字列へのボインタを指定する。上位ワードが 0 で、 



たとえば、 LoadCursorFromFile((LPWSTR)OCR_NORMAL) というよ 
うに呼び出す。 


戻り値 

正常終了 

ロー ドされ たカーソルのハン ドル 


異常終了 

NULL 


拡張エラー情報は GetLastError 閲数で取得する。 GetLastError 阅数は次の M を返す 0 



参照 — LoadCursor,SetCursor,SetSystemCursor 
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ShowCursor 

マウスカーソル表示カウントの増滅 


user 32 .dll 


95 


NT 


V C int ShowCursor( 

BOOL bShow // カーソル表示フラグ 

)； 

V B Declare Function ShowCursor Lib "user32" Alias "ShowCursor" (ByVal bShow As 

Long) As Long 

パラメータ .bShow 表示カウンターを増加させるか減少させるかを指定する。 bShow^TRVE 

の埸合には增加、 FALSE の埸合には減少される。 

戻り値 新しい表示カウント。 

解説 ShowCursor 関数はカーソルの表示、非表示を決定する内部の表示カウンターをセツ 

卜する。表示カウントが 0 以上の埸合、カーソルは表示される。初期の表示カウン 
卜は 0 である。マウスがインストールされていない埸合は表示カウントは -1 となる。 

赛 照 ClipCursor，— GetCursorPos,SetCursor,SetCursorFos 


Icon 




elconicWindows 

user 32 .dll 

95 

NT 


ンを整列 


V C UINT ArrangelconicWindows ( 

HWND hwnd // 親ウインドウハンドル 

)； 

V B Declare Function ArrangelconicWindows Lib M user32" Alias "ArrangelconicWindows" 

(ByVal hwnd As Long) As Long 

パラメータ - hwnd 親ウィンドウハンドル 

戻り傕 

拡張エラー情報を取得ずるには、 GetLastError 関数を利用する。 

解脱 親ウィンドウ中のアイコン化されたすべてのウィンドウを整列する。 

デスクトップウィンドウのハンドルは GetDesktopWindow 関数を使用して取得する。 

参 照 
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GetDesktopWindow 

















2.2 ウインドウ マネージ メン 


CreatelconFromResource 


user 32 .dll 



NT 


D 


ソースからアイコン 



ロード 



V C 


V B 


パラメータ 


戻り値 


参 照 


HICON CreateIconFromResource( 

PBYTE presbits 、 //アイコンもしくはカーソルビットへのポインタ 

DWORD dwResSize. // ビットバッファのバイト数 

BOOL /Icon 、 //アイコンフラグ 

DWORD dwVer //Windows フオー マッ ト バージョン 

)； 

Declare Function CreatelconFromResource Lib "iiser32” Alias 'CreatelconFrom 
Resource" (presbits As Byte，ByVal dwResSize As Long，ByVal flcon As Long，ByVal 
dwVer As Long) As Long 

アイコンまたは カーソル リ ソース ビットを含む バッファへの 
ポインタ。これらのビットは関数の呼び出しにより、 Lookup 
IconIdFromDirectory ( Windows 95 では LookupIconldFrom 
DirectoryEx でも 1 び能）と LoadResource |划数でロー ドされる 0 
presbits ， 气 ラメータで示されたビットセットのサイズをノマイト 
単位で指定する。 

アイコン または カーソルが 作成する必要があるかどうかを指 
定する。 このパラメータが TRUE の坳合には、 アイコンが 
作成される。 FALSE の場合には カーソルが 作成される。 
presbits パラ メータで示さ れた リソースビッ トのための アイコ 
ンのバージョン 番号または カーソル 形式を指定する。 このパ 
ラメー ターは 次の値のうちの 1 つで ある。 



すべての Win32 アプリケー ショ ンで使用するアイコンおよびカーソルは、 Windows 
3.x 互換形式である。 

正常終了 アイコン もしくは カーソルのハンドル 

異常終了 NULL 

拡張エラー怡報は GetLastError 関数で取得する。 

CreateIconrromResource ， CreateIconFromResourceJbx ， CreateIconindirect ， GetIconlnfo ， 

- ♦LoadResource,LookupIconIdtromDirectorv，LookupIconId 卜 romDirectorytx 


• presbits 

• dwResSize 

• flcon 

• dwVer 
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DispatchMessage 

user 32 .dll 

95 

NT 

メツセージのデイスバツチ 


V C 


V B 


パラメータ 
戻り値 


解説 


参 照 


LONG DispatchMessage ( 

CONST MSG *lpmsg // メッセージを含む MSG 構造体へのポインタ 

)； 

Declare Function DispatchMessage Lib "user32" Alias "DispatchMessageA" (lpMsg As 
MSG) As Long 

• Ipmsg メッセージを含む MSG 構造体へのポインタである。 

戻り値は、ウィンドウプロシージャが返す値を示す。戻り M の意味はディスパッチさ 
れたメッセージにより輿なるが、一般に戻り値は無祝される。 

ウィンドウプロシージャにメッセージをディスパッチする。通常は 、 GetMessageWil 
数で取得したメッセージをディスパッチするために利用される。 

MSG 構造体は、有効なメッセージの他 { を含んでいなければならない。 Ipmsg パラメー 
夕が WM_TIMER メッセージを指すポインタで、 WM_T1MER メッセージの / 尸 aram パ 
ラメータが NULL でない場合、 IParam はウイン ドウプロシージャの代わりに呼び出 
される関数を指すポインタとなる。 

GetMessage ， PeekMessage ， PostAppMessage ， PostMessage ， TranslateMessage ， —MSG，— 
WM TIMER 
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GetMessage 



-一からメ ッ セージを 取得 


2.2 ウインドウマネージメ 


user 32 .dll 



NT 



パラメータ 


戻り値 


解説 


BOOL GetMessage( 

LPMSG IpMsg, 

HWND hWnd ， 

UINT wMsgFilterMin, 
UINT wMsgFilterMax 

)； 


//MSG 構造体へのポインタ 
//ウィンドウを識別するハンドル 
//最初のメッセージ識別子 
//撮後のメッセージ識別チ 


Declare Function GetMessage Lib "user32" Alias "GetMessageA" (IpMsg As MSG ， 
ByVal hwnd As Long，ByVal wMsgFilterMin As Long，ByVal wMsgFilterMax As 
Long) As Long 


• IpMsg 


hWnd 


メッセージキューから取り出すメッセージを識別する MSG 構造体へのポ 
インタを指定する。 

メッセージを取り出すウィンドウを識別するハンドルを指定する。次の 
侦のいずれかはそれぞれ予約された特殊な意味を持つ。 


NULL 

wMsgFilterMin 

wMsgFilterMax 


メッセージを取得した場合 
WM.QUIT を取得した坳合 
異儆終了 


总味_ 

GetMessage は、 PostThreadMcssage を経たあらゆるウイン 
メッセージも取り出す。 

取り出される W も低いメッセージ fc * (の粮数 fo * (を指定する。 

取り出される W も“いメッセージ姑の整数 fe 1 (を指定する。 
セージを含む MSG 祸造体へのポインタである。 

TRUE 

FALSE 


ドヴ 


メッセージループを終えプログラムを終了するかを決めるために、アプリケー シヨ 
が庚り值を用いる。 

IsChild ， —MSG ， PeekMessage ， PostMessage ， PostThreadMessage，WaitMessage 
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E 


ッ セージの送信 


e 

user32.dll 

95 

NT 


パラメータ 


戻り値 

解説 


LRESULT SendMessage( 

HWND h\Vnd y 

UINT Msg ， 

WPARAM wParam, 

LPARAM IParam 

)； 


// 送信先ウィンドウを識別するハンドル 
//送信するメ ッセージ 
//メ ツセージ 第 1 パラメータ 
//メ ッセージ 第 2 パラメータ 


Declare Function SendMessage Lib ”user32 •’ Alias "SendMessageA” (ByVal hwnd As 
Long，ByVal wMsg As Long，ByVal wParam As Long，IParam As Long) As Long 


hWnd 


Msg 

wParam 

IParam 

hWnd 


侦 . 

NULL 

wMsgFilterMin 

wMsgFilterMax 


Windows がメッセージを受け取るウィンドウを識別する。パラメータが 
HWND_BROADCAST の埸合は、メッセージはシステムのすべてのトッ 
プレベルウィンドウに送られるが、子ウィンドウには送信されない。 
送信されるメッセージを指定する。 

メ ッ セージの 第 1 パラメータを 指定す る。 

メッセージキューから取り出すメッセージを識別する MSG 構造体への 
ポインタを指定する。 

メッセージを取り出すウィンドウのハンドルを指定する。次の値は、い 
ずれも予約された特殊な意味を持つ。 

GetMessage は、 PostThreadMessage を終たあらゆるウインドウ 
メッセージも取り出す。 

Min 取り出される«も低いメッセージ W の铍数 W を衍定する。 

Max 取り出される«も？; 5 いメッセージ値の粮数 W を指定する。メッ 

セージを含む MSG 構造体へのポインタである。 


送信されたメッセージにより異なる。 

指定されたウィンドウが呼び出し元スレッドにより作成されている場合は 、 Windows 
が直ちにサブルーチンとして呼ばれる。指定されたウィンドウが、異なるスレッドで 
作成されている場合には、 Windows はそのスレッドに処理を移す。 

InSendMessage ， PostMessage，SendDlgItemMessage 
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2.2 ウィンドウマネージメント 



マウスキャプチャーを終了する 


V 

C 

BOOL ReleaseCaptureO; 

V 

B 

Declare Function ReleaseCapture Lib "user32" Alias "ReleaseCapture”（）As Long 

戻 

り値 

正饼終了 

TRUE 



輿常終了 

FALSE 

解 

説 

アブリケーシ 

ョンは、 SetCapairel 対数を呼んだ後にこの閲数を呼ぶ。 

參 

照 

GetCapture，— 

* SetCapture，— WM_C APTURECH ANGED 


SetCapture 

user 32 .dll 

95 

NT 

マウスキャブチャーを開始する 


v HC ■ HWND SetCapture( 

HWND hWnd //ウィンドウを識別するハンドル 

)； 


V B Declare Function SetCapture Lib _ ， user32" Alias "SetCapture" (ByVal hwnd As Long) 



As Long 


パラメータ 

• hwnd 

マウスキャプチャーを開始するウィンドウを識別するためのハンドル 
を指定する。 

戻り値 

正常終了 

異常終了 

以前のマウスキャプチャーが開始されていたウィンドウハンドル 

NULL 


解脱 アクティブウィンドウだけがマウスキャプチャーを実行できる。 

参 照 GetCapture，— ReleaseCapture，— WM_CAPTURECHANGED 
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SetDoubleClickTime 

user 32 .dll 

95 

NT 

ダブルクリックの間隔を設定する 


v c BOOL SetDoubleClickTime( 

UINT ulnterval //ダブルクリック間隔 

)； 

V B Declare Function SetDoubleClickTime Lib M user32" Alias "SetDoubleClickTime" 

(ByVal wCount As Long) As Long 

パラメータ • ulnterval ダブルクリックの間隖をミリ秒単位で指定する。パラメータカ沁に,设 

定された坳合には、デフォルトであるダブルクリック間隔が 500 ミリ 
秒となる。 

戻り値 正常終了 TRUE 

異常終了 FALSE 

解説 SetDoubleClickTime 関数はシステムのすべてのウインドウのダブルクリック間隔を変 

更する。 

参 照、 GetDoubleClickTime 


Paintinq and Drawina 



v c HDC BeginFaint ( 

HWND hwnd, // 再描画するウィンドウハンドル 

LPFAINTSTRUCT Ipps ， // 描 _ 怡報を受け取る PAINTSTRUCT 構造体への 

ポインタ 

)； 

V B Declare Function BeginPaint Lib "user32" Alias "BeginPaint" (ByVal hwnd As Long ， 

IpPaint As PAINTSTRUCT) As Long 


パラメータ • hwnd 再描画するウィンドウを識別する。 

• Ipps 描画情報を受け取る PAINTSTRUCT 構造体へのボインタである。 

戻り 値 正常終了 |_ ディスプレイデバイスコンテキスト （ DC ) のハンドル 

異常終了 NULL 
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2.2 ウインドウマネージメント 


解説 指定されたウィンドウに対して描画の咿備をし、 PAINTSTRUCT 構造体に描画に関 

する情報を格納する。 

描画される領域にキヤレットがある場合、 BeginPaint 関数は消去されないように自動 
的にキヤレットを隠す。ウィンドウのクラスが背景色のブラシを持っている埸合、 
BeginPaint 関数が制御を戻す前にそのブラシを使⑴して、更新リージョンの背景を消 
去する。 

参 照 EndPaint ， InvalidateRect ， InvalidateRgn ， ValidateRect ， ValidateRgn ， —PAINTSTRUCT ， 

—RECT，—WM PAINT，—WM ERASEBKGND 


Draw An i mated Rects 

user32.dll 

95 

NT 

アニメーシヨン描画領域の作成 





V C BOOL WINAPI DrawAnimatedRects( 

HWND hwnd. //ウィンドウを識別するハンドル 

int idAni, //アニメー シヨンハンドル 

CONST RECT *//7/rf>c;m ， //SMALL_RECT 構造体へのポインタ 

CONST RECT *lprcTo //SMALL_RECT 構造体へのポインタ 


Declare Function DrawAnimatedRects Lib M user32 M Alias M DrawAnimatedRects M 
(ByVal hwnd As Long，ByVal idAni As Long，IprcFrom As Rect, IprcTo As Rect) As 
Boolean 


パラメータ 

• hwnd 

長方形領域をクリップされたウィンドウを識別するハンドルを指定す 
る。 


• idAni 

0 を指定しなければならない。 


• IprcFrom 

W 小化されたウィンドウの位置とサイズを指定する SMALL_RECT 構 
造体へのポインタを指定する。 


• IprcTo 

元の大きさに戻されたウィンドウの位费とサイズを指定する SMAL し 
RECT 構造体へのポインタを指定する Z 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


参 照 -^SMALL.RECT 
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RedrawWindow 


•ンドウを再描画する 


W 



V C 


BOOL RedrawWindow( 

HWND hWnd, 

CONST RECT *lprcUpdate ， 
HRGN hrgnUpdate, 

UINT flags 

)； 


//ウィンドウを識別するハンドル 
//RECT 構造体へのポインタ 
//更新するリージョンを識別するハンドル 
//再描画フラグの配列 


パラメータ 


Declare Function RedrawWindow Lib ”user32” Alias ’ RedrawWindow" (ByVal hwnd 
As Long, IprcUpdate As RECT，ByVal hrgnllpdate As Long, ByVal fuRedraw As 
Long) As Long 

• hwnd 冉描画するウィンドウを識別するハンドルを指定する。 NULL が指定 

された場合は、デスクトツプが再描画される。 

• IprcUpdate 再描画する長方形領域を指定する RECT 構造体へのポインタを指定す 

る 。 /zr ぎパラメータが領域を識別する場合、このパラメータは 
無視される。 

• hrgnUpdate 更新領域を識別する。 hrgniJpdate ヒ IprcUpdate パラメ '- 夕の [Aj 方が 

NULL の坳合、クライアント領域全体が更新領域に指定される。 

• flags 丨つ以上の再描画フラグを指定する。 

ウィンドウもしくはコントロールの再描画を無効にするために、次の 
値のいずれかを指定する。 


« (無効化） 
RDW ERASE 


RDW FRAME 


RDW INTERNALPAINT 


总味_ 

ウィンドウの洱描！* j 時に WM_ERASEBKGND メッセー 
ジを受け取る。 RDWJNVAL 1 DATE フラグを同時に指 
定しなければならない。 

WM_NCPAINT メッセージを受け取る 0 RDW _ 
INVALIDATE フラグを同時に指定しなければならな 
い。 RDWJJPDATENOW または RDW.ERASENOW 
が指定されない限り、 WM_NCPAINT メッセージは 
RedrawWindow の実行の問に送られない。 

無効部分に開係なく WM.PAINT メッセージを送信す 


RDW INVALIDATE 


IprcUpdate または hrgn Update を無効にする 0 両パラメ 
一夕が NULL の場合には、ウィンドウ全体が無効化さ 
れる。 


ウィンドウもしくはコントロールの再描画を有効にするために、次の 
値のいずれかを指定する。 
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2.2 ウインドウマネージメント 


m (有効化） 

总味 

RDW.NOERASE 

V 、かなる WM.ERASEBKGND メッセージも抑制する 

RDW.NOFRAME 

いかなる WM_NCPAINT メッセージも抑制する。 
RDW _ VALIDATE と同時に指定しなければならない。 

RDW 一 NOINTERNALPA 1 NT 

いかなる内部 WM _ PA 1 NT メッセージも抑制する。 
NULL でな t ゝ更新領域には一切影郛しない。 

RDW 一 VALIDATE 

Iprc Update また Ai hrgnUpdate を々•効にする両パラメー 
夕が NULL の場合には、ウィンドウ全体が有効になる。 
内部の WM_PAINT メッセージには影?？しない。 

再描画を実行する場合には、次のフラグの t ゝずれかを必ず指定しなけ 
ればならない。 


意味 

RDW_ERASENOW 

対象となるウィンドウは制御が戾る前に 
WM_NCPAINT と WM_ERASEBKGND メッセージを 
受け取る。 WM _ PAINT メッセージは通常のスケジユー 
ルで受け取られる。 

RDWJJPDATENOW 

対象となるウィンドウは制御が庚る前に 
WM . NCPAINT , WM _ ERASEBKGND 、 および 
WM_PAINT メッセージを受け取る。 


デフォルトでは、 Redraw Window により影释を受けるウィンドウは 
WS_CLIFCHILDREN スタイルを持っているかどうかに依存している。 
ウインドウが RedrawWindow 関数により影響を受けるかどうかは次の 


フラグで 指定する。 

m 

意味 

RDW.ALLCHILDREN 

RDW_NOCHILDREN 

子ウィンドウが存在する場合に再描阐の対象とする。 

子ウィンドウが存在する埸合に再描画の対象としない 
再描阐するウィンドウを識別する。 


• Ipps 描画情報を受け取る PAINTSTRUCT 構造体へのボインタである。 

正常終 f 1 TRUE " 

異常終了 FALSE 

拡張エラー情報は GetLastErroi ■関数で取得する。 

デスクトップウインドウの一部を無効にするために RedrawWindow を使用する埸合、 
デスクトップウインドウは WM_PAINT メッセージを受け取らない。デスクトップを 
再描画するために WM_ERASEBKGND メッセージを生成させる場合、アプリケーシ 
ヨンは RDW_ERASE フラグを使う。 

— GetUpdateRect ， GetUpdateRgn ， InvalidateRect ， InvalidateRgn ，— RECT ， 

— UpdateWindow 
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date Window 1 _ user32 . di1 _1 95 1 NT 

ンドウを更新する 


HHHBK BOOL UpdateWindow( 

HWND hWnd //ウィンドウを識別するハンドル 

)； 

V B Declare Function UpdateWindow Lib M user32" Alias "UpdateWindow" (ByVal hwnd As 

Long) As Long 

パラメータ • hwnd 再描画するウィンドウを識別するハンドルを指定する 0 

戻り 傕 

香 照 ExcludeUpdateRgn ， —GetUpdateRect ， —GetUpdateRgn ， InvalidateRect ， InvalidateRgn ， 

—WM PAINT 



Rectangle 


IntersectRect 


2 つの長方形の重なりを計算 


user 32 .dll 



■BHB? BOOL IntersectRect( 

LPRECT IprcDst ， // 重なりの結果を示す RECT 構造体へのポインタ 

CONST RECT *!prcSrcJ ， // 第 I の長方形を示す RECT 構造体へのポインタ 
CONST RECT *lprcSrc2 // 第 2 の長方形を示す RECT 構造体へのポインタ 

)； 

V B Declare Function IntersectRect Lib _’user32" Alias "IntersectRect" (lpDestRect As 

RECT, IpSrc 1 Rect As RECT, lpSrc2Rect As RECT) As Long 

パラメータ • IprcDst 2 つの長方形の重なりを受け取るための RECT 構造体へのボインタを 

指定する。 

• IprcSrcI 第 1 の長方形を指定する RECT 構造体へのボインタを指定する。 

• lprcSrc2 第 2 の長方形を指定する RECT 構造体へのポインタを指定する。 


戻り 値 

重なりがある場合 

TRUE 


それ以外 

FALSE 


拡張エラー情報は GetLastError 関数で取得する。 

参 照 


62 


InflateRect，— OffsetRect，— RECT.UnionRect 


















2.2 ウインドウマネージメント 


OffsetRect 

user 32 .dll 

95 

NT 

指定された長方形を移動する 


v c BOOL OffsetRect( 


LPRECT Iprc ， 

//RECT 構造体へのポインタ 

int dx ， 

// 水平移動位 K 

int dy 

// 垂逭移®;位 IS 


)； 


v b Declare Function OffsetRect Lib M user32" Alias "OffsetRect H (IpRect As RECT，ByVal 

x As Long，ByVal y As Long) As Long 

パラメータ • Iprc 移動する長方形の論理座標を格納する RECT 構造体へのポインタを指定する。 

• dx 長方形を水平移動するための値を指定する。左方向は負の値、右方向は正 

の値を指定する。 

• dy 長方形を垂疽移動するための値を指定する。上方向は負の値、下方向は正 

の値を指定する。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怡報は GetLastError 関数で取得する 0 
参 照 InflateRect，— IntersectRect’UnionRect，— RECT 


SetRect 

user 32 .dll 

95 

NT 

長方形の座標領域を設定 


BOOL SetRect( 


LPRECT 

lprc y 

//RECT 構造体へのポインタ 

int 

xLefi 、 

// 左端の X 座標 

int 

yTop ， 

// 上端の Y 座標 

int 

xRight, 

// 右端の X 座標 

int 

yBottom 

// 下端の Y 座標 


)； 


Declare Function SetRect Lib M user32" Alias "SetSelect” (IpRect As Rect，ByVal XI As 
Long，ByVal Y1 As Long，ByVal X2 As Long，ByVal Y2 As Long) As Long 
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パラメータ • Iprc 設定された長方形の論理座樑を受け取る RECT 構造体へのポインタを 

指定する。 

• xLeft 設定される長方形の左端の X 座標を指定する。 

• yTop 設定される長方形の上端の Y 座標を指定する。 

• xRight 設定される長方形の右端の X 座標を指定する。 

• yBottom 設定される長方形の下端の Y 座標を指定する。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怡報は GetLastError 関数で取得する 0 
参 照 CopyRect’SetRectEmpty，—RECT 


Timers 


KillTimer 


タイマーイベントを削除 


user 32 .dll 



NT 


■BBC BOOL KillTimer( 

HWND h\Vnd y //ウィンドウを識別するハンドル 

UINT uIDEvent "タイマー識別子 

)； 

v B Declare Function KillTimer Lib M user32" Alias "KillTimer” (ByVal hwnd As Long ， 

ByVal nIDEvent As Long) As Long 

パラメータ • hWnd 削除するタイマーと関連付けられたウィンドウを識別するハンドルを 

指定する。 

• uIDEvent 削除されるタイマーを指定する。 /iHW に NULL を指定し SetTimer 関 

数を呼び出した埸合、このパラメータは、 SetTimer により戻された夕 
イマー識別子である。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー情報は GetLastError 関数で取得する 0 
参 照 —SetTimer，—WM TIMER 
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SetTimer 

システムタイマーを作成 



V(^i^ UINT SetTimer( 

HWND hV/nd, //ウィンドウを識別するハンドル 

UINT n/DEveru, //タイマー識別子 

UINT uElapse ， //タイマーイベント問隔 

TIMERPROC IpTimerFunc //タイマーイベントプロシージャへのポインタ 

)； 

V B Declare Function SetTimer Lib ”user32’’ Alias ’SetTimer” (ByVal hWnd As Long, 

ByVal nIDEvent As Long, ByVal uElapse As Long，，ByVal IpTimerFunc As Long) As 
Long 


パラメータ 

• hWnd 

タイマーイベントと I 划述付けられたウィンドウを識別するハンドル 
を指定する。パラメータに NULL を指定した埸合、ウィンドウは夕 
イマーと結び付けられず、 nIDEvent パラメータは無視される。 


• nIDEvent 

0 以外のタイマー識別子を指定する。 AWm/ パラメータが NULL の場 
合、このパラメータは無視される。 


• “Elapse 

タイマーイベント問碱をミリ秒で指定する。 


• IpTimerFunc 

タイマーイベントが発生した際に実行される関数へのポインタを指 
定する。 /pTVmerf'wm: パラメータが NULL の埸合、システムは WM__ 
TIMER メッセージを送信する。 MSG 構造体の hwnd メンバは /iWm/ 
パラメータの値を含む 0 

戻り値 

正常終了 

タイマー識別子 


異常終了 

0 


参照 — KillTimer，— MSG ， TimerProc,— WM_TIMER 
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HINSTANCE hlnstance ， 

LPCTSTR IpClassName, 
LPWNDCLASS IpWndClass 


// アプリケーションのインスタンスを識別 
するハンドル 

//クラス名を格納する文字列へのポインタ 
//WNDCLASS 構造体へのポインタ 


V B 


パラメータ 


参 照 


Declare Function GetClassInfo Lib "user32 M Alias "GetClassInfoA" (ByVal hlnstance 
As Long，ByVal IpClassName As String，IpWndClass As WNDCLASS) As Long 

クラスを作成したアプリケーションを識別するハンドルを指定する。 
クラス名を含む NULL で終わる文字列へのポインタを指定する。 
クラス怙報を格納する WNDCLASS 構造体へのポインタを指定す 
る 0 


hlnstance 

IpClassName 

IpWndClass 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怙報は GetLastErroi • 関数で取得する 0 

GetClassLong ， GetClassName ， GetClassWord,GlobalAddAtom ， —RegisterClass, 
— WNDCLASS 


RegisterClass 

user32.dll 

95 

NT 

クラス情報を登録 


ATOM RegisterClass( 

CONST WNDCLASS IpWndClass //WNDCLASS 構造体へのポインタ 


v B Declare Function RegisterClass Lib "user32" Alias 'RegisterClass" (Class As 

WNDCLASS) As Long 

パラメータ • IpWndClass 登録するクラス情報を格納した WNDCLASS 構造体へのポインタを 

指定する。 
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2.2 ウィン ドウマネージ メント 


戻り値 

正常終了 

登録されたクラスを識別するアトム 


輿常終了 

0 


拡張エラー情報は GetLastErrorl 対数で取得する 0 

解説 贷鉍されたすべてのクラスは、アプリケーション終了時にすべての登録を抹消され 

る。 

参照 — CreateWindow ， CreateWindowEx，— GetClassInfo,GetClassName，— UnregisterClass, 

— WindowProc，— WNDCLASS 


UnregisterClass 

user32.dll 

95 

NT 

クラス情報をクラステーブルから削除 


V C 


V B 

パラメータ 


戻り値 


解説 

参 照 


BOOL UnregisterClass( 

LPCTSTR IpClassName ， // クラス名を格納した NULL で終わる文字列 

へのポインタ 

HINSTANCE hlnstance // アプリケーションのインスタンス を識別す 

るハンドル 


)； 


Declare Function UnregisterClass Lib ’ •user32 M Alias ,f UnregisterClassA M (ByVal 
lpCIassName As String, ByVal hlnstance As Long) As Long 


• lpCIassName クラス名を格納する NULL で終わる文字列へのポインタを指定す 

る。 

• hlnstance クラスを作成したアプリケーションのインスタンスを識別するハン 

ドルを指定する。登録するクラス情報を格納した WNDCLASS 構造 
体へのポインタを指定する。 


正常終了 TRUE 

輿常終了 FALSE 

拡張エラー怡報は GetLastError 関数で取得する。 

閲数を実行する前に、アプリケーションは削除するクラスにより作成されたすベての 
ウィンドウを破棄しなければならない。 

Global AddAtom，— RegisterClass 
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Window Property 



v c HANDLE GetProp( 

HWND hWnd, // ウィンドウを識別するハンドル 

LPCTSTR IpString //文字列もしくはアトム 

)； 

V B Declare Function GetProp Lib "user32" Alias "GetPropA” (ByVal hwnd As Long ， 

ByVal IpString As String) As Long 

パラメータ • hWnd プロパティリストを検索するウィンドウを識別するハンドルを指定する。 

• IpString NULL で終わる文字列へのポインタもしくは文字列を識別するアトムを 

指定する。アトムを指定する埸合、 GlobalAddAtom 関数で得た値で 
なければならない。アトム （ 16 ビット）は、 IpString パラメータの T 位 
ワードに跋かれ、上位ワードは 0 である。 

戻り 値 プロパティリス トに文字列を発見した埸合 | _ ハンドル 

それ以外 NULL 

参 照 EnumProps ， GlobalAddAtom ， RemoveProp，—SetProp 



V C 

V B 

パラメータ 


BOOL SetProp( 

HWND hWnd, //ウィンドウを識別するハンドル 

LPCTSTR IpString ， //文字列へのポインタもしくはアトム 
HANDLE hData //プロパティ値へのハンドル 

)； 

Declare Function SetProp Lib "user32" Alias "SetPropA" (ByVal hwnd As Long, ByVal 
IpString As String，ByVal hData As Long) As Long 

• hWnd エントリを追加するプロパティリストを含むウインドウを識別するハン 

ドルを指定する。 
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2.2 ウインドウ マネージ メント 


戻り値 

参 照 


• IpString NULL で終わる文字列へのポインタ、もしくは文字列を識別するアトム 

を指定する。アトムを指定する埸合、 GlobalAddAtom 関数で得た値で 
なければならない。アトム （16 ビット） は、 IpString パラメータの飞位 
ワードに置かれ、上位ワードは0である。 

• hData プロパティ リストに格納するデータを識別するための ハン ドルを指定す 

る。 

正常終了 TRUE 

異常終了 FALSE 

EnumProps ， EnumPropsEx ，— GetProp ， GlobalAddAtom，RemoveProp 
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2. 3 Windows Controls 

ウインドウコントロール 

Windows アブリケーションでは、システムが提供する各種のコントロールオブ 
ジェクトを利用してプログラミングを進める0これらのコントロールを利用す 
ることで、作成されるアプリケーションは標準的かつ共通のユーザーインター 
フェイスオブジェクトを簡単に利用できる。 


CommonControls 



GetEffectiveClientRect 


95 

NT 

クライアント領域矩形範囲計算 


V C 


パラメータ 


解説 

参 照 


void GetEffectiveClientRect( 

HWND h\Vnd t // ウ イン ドウ ハンドル 

LPRECT Iprc, //RECT 構造体へのポインタ 

PINT Iplnfo //コントロール識別子の配列へのポインタ 

)； 

• hWnd 対象となるクライアント領域のウィンドウハンドル。 

• Iprc 矩形範囲がセットされる RECT 構造体へのボインタ。 

• Iplnfo クライアント領域上のコントロールの 16 ビットコントロール識 

別子の配列へのポインタ。各コントロールは 2 つの配列要素か 
らなる。丨番目の要素は、 0 以外でなければならない。 2 番目の 
要素が、コントロール識別子である。この配列の M 後の要素は 
0 でなければならない。 

GetEffectiveClientRect 関数は、クライアント領域の矩形範 [ 用を計算する。この関数 
はアプリケーションを制限する。 


—RECT 
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2.3 ウインドウコントロール 


InitCommonControls 


95 

NT 

コモンコントロール DLL 確立 


V 

C 

解 

説 


void InitCommonControls(); 

InitCommonComrols 閲数は、ロー ドされたコモンコントロールダイナミックリンクラ 
イブラリ (DLL) を確立する。 


ShowHideMenuCtl 


95 

NT 

メニュー 項目チ ヱ ック属性と表示非表示設定 


V C 


パラメータ 


BOOL ShowHideMenuCtl( 

HWND hWnd ， //MDI 子ウインドウハンドル 

UINT uFlags, //メッセージ 

LPINT Iplnfo //fci 初のメッセージパラメータ 

)； 

• h Wnd メニューやコントロー ルのあるウインドウノヽンドル 0 

• uFlags チヱックマークの受け渡しのメニュー項 H 識別子。 

• Iplnfo M の組み合わせの入った配列のポインタ。 W 初の組み合わせの 2 番目の 

侦は アプリケーションのメニュー 項目 ハンドルで ある。次に メニュー 項 
0 識別子と コント ロール ウィンドウ 識別子の組み合わせが減く。この 1 划 
数は、がにあった値を検出する。値が検出されたら、 メニュー 項 
目をチヱ ック またはチェ ッ クを取り消し、対応する コント ロールを表ボ 
または非表示にする。 


戻り値 

処理を実行 

TRUE 


処理を実行しなかった 

FALSE 


解説 ShowHideMenuCtl 関数は、指定された メニュー 項目のチェックマーク 诚 性のセットお 

よび削除をする。また、対応する コントロールを 表示 や 非表示にする。この開数は指 
定された メニュー 項目に チェックマークがない 場合は セットし、 対応する コントロー 
ルを 表示する。 メニュー 項目に チェックマークが ある場合は、 チェックマークを 取り 
消し、対応する コントロールを 非表示にする。 
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Drawlnsert 


95 

NT 

アイコン描画 


void Drawlnserl ( 


HWND handParenU // 親ウインドウハンドル 

HWND hLB, //ドラッグリストボックスハンドル 

int nltem //アイコン識別子 

)； 


パラメータ 


• handParent ドラッグリストボックスの親ウインドウハンドル 0 

• hLB ドラッグリストボックスハンドル。 

• nltem 描画されるアイコン識別子。 


解説 Drawlnsert 関数は、指定されたドラッグリストボックスの親ウィンドウに挿入アイコ 

ンを描画する。 


LBItemFromPt 


95 

NT 

リスト項目インデックス検出 


V C 


パラメータ 


int LBItemFromPt ( 

' HWND hLB, // リストボックスハンドル 

POINT pt, //POINT 構造体 

BOOL bAutoScroll // スクロールフラグ 

)； 


• hLB チェックするリストボックスハンドル。 

• pt チヱックされた画面座標がセットされる POINT 構造体。 

•bAutoScroll スクロールフラグ。このノ《ラメータが TRUE で、ポインタがリスト 

ボックスを上下する埸合、この関数はリストボックスを1行墘位 
でスクロールさせ、 -1 を返す。それ以外の埸合は、リストボック 
スのスクロールはしない。 


戻り値 

ポインタがリスト項目 

項目識別子 


それ以外 

-1 


LBItemFromPt 関数はリストボックスで指定された先の項目インデックスを検出する。 


参照 —DL DRAGGING ，— POINT，—WM MOUSEMOVE 
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2.3 ウインドウコントロール 



MakeDraqList 


ドラッグリストボックス作成 


V C 


パラメータ 


戻り値 


解脱 


BOOL MakeDragList ( 

HWND hLB //リストボックスハンドル 

)； 


hLB 


単一選択リストボックスハンドル< 


正常終了 TRUE 

異常終了 FALSE 

MakeDragList 関数は蜞一選択リストボックスをドラッグリストボックスに変史する。 


Property Sheet 


AddPropSheetPageProc 



NT 


ブロバテ 



ページ追加 


V C BOOL CALLBACK AddPropSheetPageProc ( 

HPROPSHEETFAGE hpage ， // プロパティシートページハンドル 

LPARAM IParam //32ビット値 

)； 


バ フメー タ • hpage プロパテイシートぺージハンドル 0 

• IParam アプリケーション定義の32ビット値。 

戻り値 正常終了"! TRUE 

異常終了 FALSE 

解説 AddPropSheetPageProc 関数は、プロパティシート拡張でプロパティシートにページを 

追加するときに使うアプリケーション定義のコールバック関数を指定する。 

蚕 照 — HPROPSHEETPAGE，—CreatePropertySheetPage 
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CreatePropertvSheetPage 


95 

NT 

新規プロパティシートページ作成 


V C HPROPSHEETPAGE CreatProperty ( 

LPCPROPSHEETPAGE Ippsp //PROPSHEETPAGE 祸造体へのポインタ 


パラメータ 

• Ippsp 

プロパティシー トの ページを 定義する、 PROPSHEETPAGE 構造体への 
ポインタ。 

戻り値 

正常終了 

プロパティシー トの ハンドル 


與你終了 

FALSE 


解脱 CreatePropertySheetPagelW 数は、プロパティシートに新規ページを作成する 0 

アプリケーションは、新規ページを含むプロパティシートの作成時にこの関数を使用 
し、既存のプロパティシートに新規ページを追加するときに PSM _ ADDPAGE メッセ 
ージを使用する。 

Windows 95では、 ® 大16,364個のウィンドウハンドルをサボートする。 

参照 — PropertySheet ，— PROPSHEETPAGE ，— PSM_ADDPAGE 


DestroyPropertySheetPaqe 


95 

NT 

ブロパティシートページ破棄 


BOOL DestroyPropertySheetPage ( 

HPROPSHEETPAGE hPSPage // プロパティ シー ト ページ ハンドル 



)； 


パラメータ 

• hPSPage 

削除するプロパティシートページハンドル0 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


解説 Destroy Property SheetPageliy 数は、プロパティシートページを破棄する。アプリケー 

ションは、 PropertySheet 閲数で使用されていな t ゝページに対しこの関数を使用する必 
要がある。 

参照 — PropertySheet 
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2.3 ウインドウコントロール 


ExtensionPropSheetPageProc 


95 

NT 

ブロパティシート拡張 


V C 


パラメータ 


戻り僅 


解脱 


参 照 


BOO し CALLBACK ExtensionPropSheetPageProc ( 

LPVOID Ipv ， // プロパティシート項目記述ポインタ 

LPFNADDPROPSHEETPAGE IpfnAddPropSheetPageProc , 

//AddPropSheetPageProc 関数のポインタ 
LPARAM IParam //32ビット値 

)； 

• Ipv 作成されたプロパティシート項目を記述するアプリ 

ケーション定義値のポインタ。 NULL のセットも可 
能。 

• IpfnAddPropSheetPageProc AddPropSheetPageProc 関数のポインタ〇拡張ダイナ 

ミックリンクライブラリ （ DLL ) でプロパティシートに 
ページを追加するときこの関数を使用する。 

• IParam アプリケーション定義の32ビット値。 


正常終了 TRUE 

異常終了 FALSE 

ExtensionPropSheetPageProc 関数は、プロパティシートを作成したモジュールに M す 
る AddProp - SheetPageProc 関数のアドレスを受け取るアプリケーション定義のコール 
バック間数を指定する。ブロパティシートの拡張はこの関数をエクスポートしなけれ 
ばならない。 

— Add PropS hee t Page Proc 


PropertySheet 


95 

NT 

ブロパティシート表示 


V C 

int PropertySheet ( 

LPCPROPSHEETHEADER Ippsph //PROPSHEETHEADER 構造体へのポ 


)； 

インタ 

パラメータ 

• Ippsph 

プロパティシー トの フレーム や ページを 定義する 、 PROPSHEET 
HEADER 構造体へのポインタ。 

戻り値 

正常終了 

異常終了 

正の値 

-1 
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民り 値 PROPSHEETHEADER 構造体の dwFlags 項目が PSH_MODELESS フラグを指定する 

埸合は、成功時に、プロパティシートダイアログのウィンドウハンドルを返す。以下 
の戻り値は、特別な意味を持つ。 



値 

总味 


ID 一 PSREBOOTSYSTEM 

ページはプロパティシートに PSM_REBOOTSYSTEM メッセ 
ージを送る。コンピュータはユーザーの変®を実施するため 
再起動し なければならない。 


ID_PSRESTARTWINDOWS 

ページはプロパティシートに PSM_RESTARTWlNDOWS メ 
ッセージを送る。 Windows はユーザーの変史を火 施す るた め 
再起勁 しなければならない。 

解脱 

デフ オル トでは、プロパティシートは モーダル ダイアログを作成する。 
PROPSHEETHEADER 構造体の dwFlags 項 H が PSH_MODELESS フラグを指定した 
埸合は、プロパティシートは、モードレスダイアログを作成し、ダイアログ作成後す 
ぐに制御を戻す。この場合、プロパティシートの戻り値は、モードレスダイアログの 


ウインドウハンドルである 0 

モー ドレスプロパティシー トのため、 メツセージループでプロパティシートダイアロ 
グメッセージを 渡すために PSMJSDIALOGMESSAGE を 使う。 メツセージループで 
ダイアログを 破褒するとき終了するために PSM.GETCURRENTPAGEHWND を 使う。 
ユーザーが OK かキヤンセルボタンを迸択 したとき、 PSM.GETCURRENT 
PAGEHWND は NULL を 返し、 DestroyWindowl 划数により ダイアログを 破棄する。 

参照 — Destroy Window，— PROPSHEETHEADER，— PSM_GETCURRENTPAGEHWND, 

— PSM JSDIALOGMESS AGE，— PSM_REBOOTS YSTEM ， 

—PSM RESTARTWINDOWS 


PropSheetPageProc 


95 

NT 

ブロパティ シー ト ページ 初期化 


v C UINT CALLBACK PropSheetPageProc( 


HWND 

hwnd, 

//予備 

UINT 

uMsg, 

// アクションフラグ 

LPPROPSHEETPAGE 

ppsp 

//PROPSHEETPAGE 梢造体へのボインタ 


)； 

パラメータ - hwnd 将来のために予約。 NULL でなければならない。 

- uMsg アクションフラグ。このパラメータは、以下の値である。 



意味 

PSPCB 一 CREATE 

ページが作成される。ページの作成が許可された坳合、0以外 
が返る。0の場合、作成されない。 

PSPCB RELEASE 

ページが消去される。返り W は、無祝される。 
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2.3 ウィンドウコントロール 


ページの作成や消去の定義をする PROPSHEETPAGE 構造体のポイン 
夕〇 


戻り 値 戻り値は、呼の値による。 


解説 PropSheetPageProc 関数は、ページを作成したり破棄するときに、プロパティシート 

が呼ぶアプリケーション定義のコールバック閲数を指定する。アプリケーションは、 
この関数を使いページの初期化やオペレーシヨンをクリアする。アプリケーシヨンは、 


CreatePropcrtySheetPage 関数を呼び PROPSHEETPAGE 構造体のアドレスを指定する 
前に、構造体の pfnCallback 項目にコールバック関数のアドレスを指定しなければな 
らない。 

参 照 — CreatePropertySheetPage，—PROPSHEETPAGE 



PropSheetProc 


ィシート初期化 



V C int CALLBACK PropSheetProc( 

HWND hwndDlg ， //プロパティシートダイアログボックスのハンドル 
UINT uMsg ， // アクションフラグ 

LPARAM IParam //〇固定 

)； 

パラメータ • hwndDlg プロパティシートダイアログボックスのハンドル。 

• uMsg アクションフラグ。プロパティシートの 初期化を 示す PSCB_ 

INITIALIZED 値が定義される。 

• IParam 0 固定。 

戻り値 この関数は、 0 を返す。 

解説 関数は、プロパティシートの初期化のためシステムが呼ぶアプリケーション定義のコ 

ールバック関数を指定する。アプリケーションは、 PropertySheet 関数を呼び 
PROPSHEETHEADER 構造体のアドレスを指定する前に、構造体の pfnCallback 項目 
にコールバック関数のアドレスを指定しなければならない。 

翏照 — PropertySheet，— PROPSHEETHEADER 
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Window 



CreateStatusWindow 


ステータス ウインドウ作成 



NT 


v c HWND CreateStatusWindow ( 

LONG style ， // ウインドウスタイル 

LPCTSTR IpszText ， // ステータステキストポインタ 

HWND hwndParent y // 親ウインドウハンドル 

UINT w/D // ステータスウィンドウのコントロール識別子 



パラメータ ステータスウィンドウのウィンドウスタイル。このパラメータには 

WS.CHILD スタイルや WS _ V 1 S 1 BLE スタイルが含まれる。 

• IpszText 最初の部分のステータステキストの NULL で終わる文字列のポイン 

夕〇 

• hwndParent 親ウィンドウのハンドル。 

• wfD ステータスウィンドウのコントロール識別子。ウィンドウ処理はこの 

値で、親ウィンドウに送るメッセージを確認する。 


戻り僱 

正常終了 

ステータスウインドウのハンドル 


異常終了 

NU 1 X 


解 6 兑 CreateStatusWindow 関数は、アプリケーションのステータスを表示するステータスウ 

ィンドウを作成する。このウィンドウは、通常親ウィンドウのボトムに表示される。 
CreateStatusWindow 関数は、ウィンドウを作成するため CreateWindow 関数を呼ぶ 0 
CreateWindow に変史なしでパラメータを渡す 0 そして配置、幅、萵さのパラメータ 
にデフォルト値をセットする。 Windows 95では、敁大16,364個のウィンドウハンド 
ルがサポートされる。 


参 照 


— CreateWindow 
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2.3 ウインドウコントロール 


DrawStatusText 


95 

NT 

ステータスウインドウテキスト描画 

V C void DrawStatusText ( 




HDC hdc t //ウィンドウの表示コンテキストのハンド 

ル 



LPRECT Iprc ， //RECT 構造体のポインタ 
LPCTSTR pszText , //表示するテキストのポインタ 
UINT uFlags //描 _ フラグ 
)； 


パラメータ 


• hdc ウインドウの表示コンテキストのハンドル。 

- Iprc テキストが描かれる矩形のカレント座標での rtdlH を含む、 RECT 構造体 

のポインタ。この関数は、矩形を指定する鉍の内側に境界線を描く。 

• pszText 表示するテキストを指定する NULL で終わる文字列へのボインタ。文 

字列のタブ文字は左詰め、右詰め、中央揃えの文字列を終わらせる。 

• "Flags テキストの描_フラグ。このパラメータは以下の侦の組み合わせであ 


る。 


意味 

SBT—NOBORDERS 

SBT 一 POPOUT 

SBT.RTLREADING 

指定されたテキストのまわりに境界線を描かない。 

テキストを [ J 立たせるため高輝度の境界線を描く。 

Windows 95でのみ指定される。へブライ, Ifi やアラビア|语のシス 
テムで右から左へ説むテキストを表示する。 


解脱 DrawStatusText _ 数は、ステータスウィンドウの境界線のスタイルに指定されたテキ 

ストを描く。 


参 照 


—RECT 
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MenuHelp 


95 

NT 

ステータス ウィンドウ ヘルプ 表示 


V C 


パラメータ 


解説 


參 照 


void MenuHelp ( 

UINT 

uMsg , 

WPARAM 

wParam , 

LPARAM 

IParam ， 

HMENU 

hMainMenu , 

HINSTANCE 

hlnst , 

HWND 

hwndSlatus 9 

UINTFAR * 

IpwIDs 


//メ ッ セージ 

/ハ番目の メ ッ セージパラメータ 
//2 番目の メ ッ セージパラメータ 
//メインメニューのハンドル 
//モジュールのハンドル 
//ステータスウインドウのハンドル 
//文字列リソースの 識別子と メニューハンドルの配 
列のポインタ 


)； 


• uMsg 

• wParam 

• IParam 

• hMainMenu 

• hlnst 

• hwndStatus 

• Ipw/Ds 


WM_MENUSELECT または WM 一 COMMAND メ ッ セ-* ジ。 

1 番目の メ ッ セージ ハ。 ラメータ0 
2 番目の メ ッ セージパラメータ。 

アプリケーションのメインメニューのハンドル。 

文字列リ ソースを 含む モジュールのハン ドル。 

ステータスウインドウのハンドル。 

文字列リ ソースの 識別子と メニューハンドルの 組み合わせの配列へ 
のポインタ。この 関数は、指定された メニューのハンドルを 配列 か 
ら検索し、妥当なヘルプ文字列をロードするため、対応するリソー 
ス識別子を使う。 


MenuHelp 関数は、 WM_MENUSELECT と WM 一 COMM AND メッセージを 処理し、 
指定され たステータスウインドウのカレントメニューのヘルプテキストを 表示する。 

修 

—WM COMMAND，—WM MENUSELECT 
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2.3 ウインドウコントロール 


Toolbar 



CreateMa 


ツールバー ビッ 


edBitma 


ヘンブ作成 



NT 


V C HBITMAP CreateMappedBitmap ( 

HINSTANCE hlnstance , // モジュール要求のハンドル 

int idBitmap ， //ビットマップリソース識別/ • 

UINT wFlags , //ビットマップフラグ 

LPCOLORMAP IpColorMap 、 // COLORMAP 構造体のポインタ 
int iNumMaps //カラーマップ番号 

)； 

パラメータ • hlnstance ビットマップリソースを含む実行ファイルのモジュール贺求のハン 

ドル。 

• idBitmap ビットマップリソースのリソース識別子。 

- wFlags ビットマップフラグ。このパラメータは0または、以下の値である。 




• IpColorMap 

ビットマップに必要な色の情報を含む COLORMAP 構造体へのボイ 
ンタ。このパラメータが NULL の場合は、デフオルトカラーマップ 
を使う。 


• iNumMaps 

IpColorMap に土 り指定されたカラーマップ番号。 

戻り値 

正常終了 

ビットマップのハンドル 


異常終了 

NULL 


解説 CreateMappedBitmap 関数は、ツールバーで使うビットマップを作成する。 
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CreateToolbarEx 


ツール バーボタン作成 



HWND CreateToolbarEx ( 


パラメータ 


HWND 

hwnd, 

// 親 ウィンドウのハンドル 

DWORD 

ws 9 

//ツールバーのウインドウスタイル 

UINT 

w / D , 

//ツ■"ルバーのコントロール識別子 

int 

nBitmaps, 

//ボタンイメー ジ番号 

HINSTANCE 

hBMInst, 

//モジュール要求 

UINT 

wBMID, 

//ビットマップリソース識別子 

し PCTBBUTTON 

IpButtons, 

//TBBUTTON 構造体の配列へのポインタ 

int 

iNumButtons, 

"ボ タン番号 

int 

dxButton, 

"ボタンの幅 

int 

dyButton, 

//ボタンの高さ 

int 

dxBitmap, 

"ボタンイメージの幅 

int 

dyBittnap, 

"ボタンイメージの高さ 

UINT 

uStructSize 

//TBBUTTON 構造体の 大きさ 


)； 

hwnd 


Vi _ 

WS.BORDER 
WS CAPTION 


WS CHILD 


WS CLIPCHILDREN 


WS CLIPSIBLINGS 


ツールバーの 親ウインドウのハン ドル。 

ツールバーの ウインドウスタイル。このパラメータは少なくとも 
WS . CHILD スタイルを指定しな ければ ならない。 ツールバー には、 
スタイルの 組み合わせを 含むことができる。 また、 トピックスを 関 
連付ける ことができる。 

_ [ 

境界を持つウィンドウを作成。 

タイトルバーを持つウィンドウを作成（咕黙に ws_ 
BORDER スタイルを持つ WS . DLGFRAME スタイル 
と一祐に使うことはできない。 

子ウィンドウを作成。 WS _ POPUP スタイルと一祐に使う 
ことはできない。 

REN 親ウィンドウの内部で描_するときに、子ウィンドウが占 

める如域を除外する。 親 ウィンドウを作成するときに使 
ぅ。 

IGS 互いに閲迚する兄弟ウィンドウをクリップする。ある特定 

の兄弟ウィンドウが描幽メッセージを受け取ったときに、 
WS . CLIPSIBLINGS スタイルは、史•新される兄弟ウィン 
ドウの領域からオーバラップするほかのすべての兄弟ウィ 
ンドウをクリップする （ WS _ CL 1 PSIBLINGS を指定しな 
いで兄弟ウィンドウがオーバラップしていると、隣の兄弟 
ウィンドウのクライアント領域内を描_できるようにな 
る）〇必ず WS CHILD スタイルと一緒に使う。 
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2.3 ウインドウコントロール 


WS 一 DISABLED 
WS.DLGFRAME 
WS 一 GROUP 


WS.HSCROLL 

WS.MAXIMIZE 

WS.MAXIMIZEBOX 

WS.MINIMIZE 

WS_MINIMIZEBOX 

WS.OVERLAPPED 

WS OVERLAPPEDWINDOW 


WS 一 POPUP 

WS 一 POPUPWINDOW 


WS 一 SYSMENU 


WS TABSTOP 


WS 一 THICKFRAME 

WS_VISIB し E 
WS_VSCROLL 


初期状態で使用禁止のウィンドウを作成。 

二®境界を持ち、タイトルを持たないウィンドウを作成。 

ユーザーが 力•向キーを使って次のコントロールに柊動でき 
るコントロールのグループの、 WW のコントロールを指 
定。のコントロールの後に WS_GROUP を使って定 
我されるコントロールは、すべて同じグループに诚す。次 
の WS_GROUP スタイルを持つコントロールはそれ以前の 
グループを終了し、次のグループを開始する。 

水平スクロールバーを持つウィンドウを作成。 

Ji 4 人表示されたウィンドウを作成。 

W 大表示ボタンを持つウィンドウを作成。 

初期状態でアイ コン 化された ウィン ドウを作成。必ず 
WS . OVERLAPPED スタイルと-•紡に使う。 

アイコン化ボタンを持つウィンドウを作成。 

オーバラップウィンドウを作成。オーバラップウィンドウ 
は、通常キャプションと境界を持つ。 

WS 一 OVERLAPPED 、 WS . CAPTION , WS — SYSMENU 、 
WS_THICKFR AME , W S _ M 1 N I M I Z E B O X 、 
WS _ MAXIM 1 ZEB 0 X スタイルを持つオーバラップウィン 
ドウを作成。 

ポップアッブウィンドウを作成。 WS . CHILD スタイルと 
一«5に使うことはできない。 

WS _ BORDER 、 WS 一 POPUP 、 WS_SYSMENU スタイル 
を持つポッブアップウィンドウを作成，コントロールメニ 
ューを" J 祝にするには、 WS _ CAPTION スタイルと 
WS . POPUPWINDOW を組み作わせなければならない。 

タイトルバーにコントロールメニューボックスを持つウイ 
ンドウを作成。タイトルバーを柃つウィンドウにだけ Wi 
ラ 0 


ユーザーが TAB キーを使って柊®!;できるコントロールの1 
つであることを指定。ユーザーが TAB キーを押すと次に 
WS _ TABSTOP スタイルを持つコントロールに柊勅でき 

る,， 


ウィンドウのサイズ変史に使うことができる、人い忭を持 
つウィンドウを作成。 

切期状態で" HJi のウィンドウを作成,， 

¢11*¢スクロールバーを持つウィンドウを作成0 


• wID ツールバーの コント ロール|裁別户。 

• nBitmaps /?がやで指定されるビットマッブのボタンイメ ージ番 

号。 

• hBMInst ビットマップリソースを含む実行フアイルのモジユール要求。 

• wBMID ビッ ト マップリソースのリソース 識別子。 が NULL の 場合、 

このパラメータは妥当なビットマップハンドルでなければならない。 
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• IpButtons ツールバーに加えるボタンの情報を含む TBBUTTON 構造体の配列 

へのポインタ。 

• iNumButtons ツールバーに加えるボタン番号。 

• dxButton ツールバーに加えるボタンの幅（ピクセル)。 

• dyButton ツールバーに加えるボタンの高さ（ピクセル)。 

• dxBitmap ツールバーに加えるボタンイメージの幅(ピクセル)。 

• dyBitmap ツールバーに加えるボタンイメー ジの高さ（ピクセル)。 

• uStructSize TBBUTTON 構造体の大きさ。 


戻り値 

正常終了 

ツールバー ウインドウの ハン ドル 


異常終了 

NULL 


解脱 CreateToolbarEx 関数は、ツールバーウィンドウを作成し、ツールバーに指定されたボ 

タンを加える。 Windows 95 では、 tei 大16,364個のウィンドウハンドルをサポートする。 

参 照 —TBBUTTON 


Up-Down Control 



CreateUpDownControl 


アップダウン 



NT 



ロール作成 


V c 


パラメータ 


HWND CreateUpDownControl ( 


DWORD 

dwStyle , 

"コントロールのウインドウスタイル 

int 

X ， 

//水平座標 

int 

ス 

//垂直座標 

int 

cx . 

//上下コントロールの幅 

int 

cy ， 

//上下コントロールの高さ 

HWND 

hParent ， 

"親ゥィン ドウのハンドル 

int 

nID ， 

//上下コントロールの識別子 

HINSTANCE 

hlnst , 

//モジュール要求ハンドル 

HWND 

hBuddy , 

//上下コントロールに関連するウィンドウのハンドル 

int 

nUpper ， 

//上下コントロールの上限 

int 

nLower % 

//上下コントロールの下限 

int 

nPos 

"コントロールの配餺 


• dwStyle コントロールのウインドウスタイル。このパラメータは WS _ CHILD 、 

WS _ BORDER 、 WS _ VISIBLE スタイルを含むが、上下コントロールを 
指定するウィンドウスタイルは、含まない。指定できる値は 
AiustWindowRect を参照。 
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2.3 ウインドウコントロール 


戻り値 


解 説 


• ズ クライアント座標の中のコントロールの 左上 隅の水平座標。 

• y クライアント座標の中のコントロールの 左上 隅の垂直座標。 

• CX 上下コントロールの幅（ピクセル)。 

• cy 上下 コントロールの 高さ （ピクセル)。 

• hParent 上下コントロールの親ウィンドウのハンドル。 

• nlD 上下コントロールの識別子。 

• h/nst 上下コントロールを作成するアプリケーションのモジユール嫂求ハンド 

ル 0 

• hBuddy 上下コントロールに関速するウィンドウのハンドル。このパラメータが 

NULL のとき、コントロールには関連したウィンドウがない。 

• nUpper 上下コントロールの上限。 

• nLower 上トコントロールの卜限。 

• nPos コント ロールの fit ! 置。 


正常終了 アップダウンコントロールのハンドル 

輿常終了 NULL 

CreateUpDownControl 関数は、上下コントロールを作成する。 Windows 95 では、最 
大 16,364 個のウインドウ ハン ドルをサボートする0 





| Button 



CheckDlgButton 

user 32 .dll 

95 

NT 

ボタンコン ト ロールチヱック 属性変更 


V C 


V B 


パラメータ 


BOOL CheckDlgButton ( 
HWND hDlg ， 

int nIDButton , 

UINT uCheck 

)； 


//ダイアログボックスのハンドル 
//ボタンコントロール 識別子 
//チヱック状態 


Declare Function CheckDlgButton Lib " user 32" Alias " CheckDLGButtonA " (ByVal 
hDlg As Long , ByVal nIDButton As Long , ByVal wCheck As Long ) As Long 

• hDlg ボタンを含むダイアログボックスの識別子。 

• nIDButton 変更するボタンの識別子。 

•uCheck ボタンのチヱック状態を指定する。このパラメータは次の値の1つ 

を指定できる。 
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値 

0 

1 

# 

2 

BST-CHECKED 
BST INDETERMINATE 


BST UNCHECKED 


意味 

ボタンがチェックされていない 。 Windows 95の 
BSTJJNCHECKED と同様。 

ボタンがチェックされている 。 Windows 95の 
BST__CHECKED と同様。 

ボタンが淡色表示されて t 、る ( BS _3 STATE または、 
BS _ AUT 03 STATE スタイルの坳合のみ)。 

Windows 95の BSTJNDETERMINATE と同様。 
Windows 95のみ。ボタンがチェックされている。 
Windows 95のみ。ボタンが淡色表示されている。 
( BS —3 STATE または、 BS _ AUT 03 STATE スタイ 
ルの場合)。 

Windows 95のみ。ボタンがチェックされていない 0 


戻り値 

正格終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怙報は GetLastErroi •閲数で取得する。 

解説 CheckDlgBiittonl 対数は、ボタンコントロールを迸択(ボタンコントロールの隣りにチ 

エックマークを付加)または进択解除 ( チヱックマークを除去)する。3ステートボタン 
(3 神頌の状態を持つ)の状態を変史するときにもこの閲数を使う 。 CheckDlgButtonlJy 
数は、指定されたダイアログボックス内にある指定されたボタンコントロールに、 
BM_SETCHECK メッセージを送る。 

參 照 — CheckRadioButton ，— IsDlgButtonChecked 


CheckRadioButton 

user 32 .dll 

95 

NT 

ラジオボタンチェック属性変更 


V C 


V B 


パラメータ 


BOOL CheckRadioButton ( 


HWND 

hDlg ， 

int 

nIDFirstButton , 

int 

nIDLastButton , 

int 

nIDCheckButton 


//ダイアログボックスのハンドル 
//グループ内の w 初のラジオボタン識別子 
//グループ内の m 後のラジオボタン識別子 
//迸択す るラジオボタン識別子 


)； 


Declare Function CheckRadioButton Lib M user 32 M Alias " CheckRadioButtonA ” (ByVal 
hDlg As Long , ByVal nIDFirstButton As Long，ByVal nIDLastButton As Long，ByVal 
nIDCheckButton As Long ) As Long 

• hDlg ラジオボタンを含むダイアログボックスの識別子。 

• nIDFirstButton グループ内にある W 初のラジオボタンの識別/•を指定する。 

• nIDLastButton グループ内にある W 後のラジオボタンの識別子を指定する。 

• nIDCheckButton 選択するラジオボタンの識別/ • を指定する 0 
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2.3 ウインドウコントロール 


戻り 僅 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怡報は GetLastError 関数により取得する。 

解説 CheckRadioButton 閲数は、グループ内の指定されたラジオボタンにチェックマークを 

付加し、グループ内のそのほかのすべてのラジオボタンのチヱックマークを取り消す。 
CheckRadioButton 閲数は、指定されたグループにあるラジオボタンに、 
BM_SETCHECK メッセージを送る。 

参照 — BM 一 SETCHECK ，— CheckDlgButton ，— IsDlgButtonChecked 


IsDlgButtonChecked 

user 32 .dll 

95 

NT 

ボタンコントロール状態取得 


V C 


V B 


パラメータ 


戻り値 


UINT IsDlgButtonChecked ( 

HWND hDIg , // ダイアログボックスハンドル 

int nlDButton //ボタン識別子 

)； 

Declare Function IsDlgButtonChecked Lib M user 32" Alias ’’ IsDlgButtonChecked ’’ 
(ByVal hDlg As Long，ByVal nlDButton As Long ) As Long ByVal nIDLastButton As 
Long，ByVal nIDCheckButton As Long ) As Long 

• hDlg ボタンコントロールを含むダイアログボックスの識別子。 

• nlDButton ボタンコントロールの識別子を指定する。 


BS _ AUTOCHECKBOX 、 BS _ AUTORADIOBUTTON , BS _ AUT 03 STATE 、 
BS _ CHECKBOX 、 BS . RADIOBUTTON , BS _3 STATE スタイルのボタンの坳合の戻 
り値は、以下の値の1つである。 


値 

意味 

0 

ボタンがチェックされていない 。 Windows 95の BST 


_UNCHECKED と同様。 

1 

ボタンがチェックされている 。 Windows 95の BST 


一 CHECKED と同様。 

2 

ボタンが淡色表示されている （ BS _3 STATE または、 


BS _ AUT 03 STATE スタイルの 場合)。 Windows 95の 


BSTJNDETERMINATE と同様。 

BST 一 CHECKED 

Windows 95のみ。ボタンがチェックされている。 

BSTJNDETERMINATE 

Windows 95のみ。ボタンが淡色表示されている 


( BS .3 STATE または、 BS _ AUTO -3 STATE スタイルの 


場合)。 

BSTJJNCHECKED 

Windows 95のみ。ボタンがチェックされていない。 
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解説 IsDlgButtonChecked 関数は、ボタンがチェックされているかとうか、また3ステート 

ボタンが淡色表示、チェック、またはそのどちらでもない状態のいずれであるかを判 
断する。 IsDlgButtonChecked 関数は、指定されたボタンコントロールに 
BM_GETCHECK メッセージを送る。 

参 照 —CheckDlgButton 


| Combo Box 

□ 


DlgDirListComboBox 

user 32 .dll 

95 

NT 

バス名と一致するファイル名をコンボボックス内に一覧表示 


V C 


V B 


パラメータ 


int DlgDirListComboBox ( 

HWND hDlg t //コンボボックスを持つダイアログボックスのハンドル 

LPTSTR IpPathSpec , //パス名またはファイル名の文字列ポインタ 

int nIDComboBox 、 II コ ンボボックスの識別/ • 

int nlDStaticPatK //スタティックコントロールの識別子 

UINT uFiletype //表示するファイル W 性 


Declare Function DlgDirListComboBox Lib “ user 32” Alias " DlgDirListComboBoxA " 
(ByVal hDlg As Long，ByVal lpFathSpec As String , ByVal nIDComboBox As Long , 
ByVal nIDStaticPath As Long , ByVal wFileType As Long ) As Long 


• hDlg 

• IpPathSpec 


• nIDComboBox 


• nIDStaticPath 


コンボボックスを含むダイアログボックスの識別子。 

NULL で終わる以下の形式の文字列ポインタ。 ( drive :) 
[[\】 directory [\ directory 】...\】[ filename 】 文字列にドライブ名やディ 
レクトリ名を指定したときは、 DlgDirListComboBox 関数は、リ 
ストボックスに格納する前にカレントドライブとカレントディレ 
クトリを変更する。リストが格納されると、ドライブ名やディ 
レクトリ名の部分が削除されて、 IpPathSpec パラメータが史新 
される。 

ダイアログボックスのコンボボックスコントロールの識別子を指 
定する。このパラメータが0のとき 、 DlgDirListComboBox 関数 
はリストボックスが存在しないものとし、ファイル名やディレク 
トリを格納しない。 

カレントディレクトリの表示のために使われるスタティックテキ 
ストコントロールの識別子を指定する。このパラメータが〇のと 
き 、 DlgDirListComboBox 閲数はそのコントロールが存在しない 
ものとする。 


88 











2.3 ウインドウコントロール 


戻り値 


解説 


参 照 


• uFiletype 表示するファイル名のファイル厲性を指定する。この パラメー 

夕は、以下の値の組み合わせになる。 


値 

意味 

DDL 一 ARCHIVE 

アーカイブファイル。 

DDL.DIRECTORY 

サブディレクトリ。サブディレクトリ名は角括弧 （[1) 


の中。 

DDL.DRIVES 

ドライブ。ドライブは [- X -】 の形式で格納される。 X は 


ドライブの文字。 

DDL 一 EXCLUSIVE 

指定された诚性を持つファイル。デフォルトは、読み 


畨きファイル。 

DDL.HIDDEN 

P 念しファイル。 

DDL-READONLY 

読み取り専用ファイル。 

DDL.READWRITE 

ほかの]^性を持たない、読み畓き可能なファイル。 

DDL.SYSTEM 

システムファイル。 

DDL.POSTMSGS 

ポストメッセージをァプリケーションキューに送る。 


デフオルトは、 DlgDirList 関数がダイァログボックス 


プロシージャに直接メッセージを送る。 


正常終了 0以外 

異常終了 0 

たとえば、/ 〆 な//^ ec で指定される文字列が不正なパスであった埸合、この|対数は失 
敗する。詳細なエラー情報は GetLastErroi •関数により取得する。 



て 

◊ 

U 







関数は、指定されたコンボボックスにディレクトリのリストを格納する。この関数 
は、指定された M 性やノヽ°ス名と一致するすべてのファイルやドライブ名をリストに格 
納する。/ 〆 >如/^パラメータポインタが長さが〇の文字列を指していたり、ドライ 
ブ名やディレクトリ名が指定されたが、ファイル名が無い場合は、ファイル名は*.* 
(ワイルドカード)が指定されたとする。 WindowsNT では、ディレクトリリストは長い 
ファイル名を表示する 。 Windows 95では、ディレクトリリストは短いファイル名を 
表示する (8.3 フォーム)〇 SHGetFilelnfo や GetFullPathName 関数を使用し対応する長 
いファイル名を取得する。 

— DlgDirList ，— DlgDirSelectComboBoxEx ，— GetFullPathName，GetFileInfo 


89 


第 2 章 Win 32 API リファレンス 


DlgDirSelect 


95 

NT 

リストボックスから現在の選択項目を文字列バッファにコピーする 


V C 


パラメータ 


戻り値 


解脱 


参 照 


BOOL DlgDirSelect ( 

HWND hwndDlg ， //リストボックスを持つダイアログボックスのハンドル 
LPSTR IpszPath . //パス名またはファイル名の文字列ノ、へソファのアドレス 
int idUstBox //リストボックスの識別户 
)； 

• hwndDIg リストボックスを持つダイアログボックスの識別子 0 

• IpszPath パス名またはファイル名を格納する、128バイトのバッファへの 

ポインタ。 

• idUstBox ダイアログボックス内のリストボックスの識別子を表す幣数を 

指定する。 


正常終了 0以外の値 

異常終了 0 

DlgDirSelect 関数は、リストボックスで現在選択されている項目を取得する。この関 
数は、 DlgDirList 関数によりリストボックスにデータが格納されていることを前提と 
して動作する。逭択項目は、ドライブ名、ファイル名、またはディレクトリ名として 
処理される。 

現在进択されている項目がディレクトリ名またはドライブ名のとき、 DlgDirSelect 関 
数は、それらの名前から角括弧やハイフンを取り除いて、新い、パス名に挿入できる 
ようにする。何も遠択されていないときには、/尸 私/^/ A パラメータが指す バッファの 
内容は変わらない。 

DlgDirSelectlftj 数を使用して、リストボックスから複数のファイル名を得ることはで 
きない。尚数の項目を进択できるリストボックスではこの関数を使えない。誤って使 
用した場合、この関数は0を返さず、扣ゴ^/!パラメータの指す文字列は変更されな 

い。 

DlgDirSelect 関数は、 LB_GETCURSEL メッセージと LB.GETTEXT メッセージをリ 
ストボックスに送る。 

DlgDirSelect ^ 数は、 Win 32 API 処理ではない。 Win 32 ベースのアプリケーションは 
DlgDirSelectEx I 划数を使用する 0 


DlgDirList ，— DlgDirListComboBox ，— DlgDirSelectComboBox，DlgDirSelectEx 
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2.3 ウインドウコントロール 


DlgDirSelectComboBox 


95 

NT 

コンボボックスから現在の選択項目を文字列バッファにコピーする 


V C 


パラメータ 


戻り値 


解説 


BOOL DlgDirSelectComboBox( 

HWND hwndDlg , // リストボックスを持つダイアログボックスのハ 

ンドル 

LPSTR IpszPath . //パス名またはファイル名の文字列バッファのポイ 

ンタ 

int idComboBox //コンボボックスの識別子 

)； 

• hwndDlg コンボボックスを持つダイアログボックスの識別子0 

• IpszPath パス名またはファイル名を格納する、128バイトのバッファを指 

すボインタ。 

• idComboBox ダイアログボックス内のコンボボックスの識別子を表す整数を 

指定する。 


正常終了 0以外の値 

異常終了 0 

DlgDirSelectComboBox 関数は、コンボボックスのリストボックスで現在迸択されて 
いる項目を取得する。この関数は、 DlgDirListComboBoxI 対数によりリストボックス 
にデータが格納されていることを前提として動作する。選択項目は、ドライブ名、フ 
ァイル名、またはディレクトリ名として処理される。 

DlgDirSelectComboBox _数を使用して、コンボボックスから跑数のファイル名を得 
ることはできない。 

現在遠択されている項目がディレクトリ名またはドライブ名のとき、 
DlgDirSelectComboBox 開数は、それらの名前から角括弧やハイフンを取り除いて、 
新しいパス名に挿入できるようにする。何も選択されていないときには、 IpszPath パ 
ラメータが指すノ、'ソファの内容は変わらない。 

DlgDirSelectComboBox 開数は、 CB_GETCURSEL メッセージと CB_GETLBTEXT メ 
ッセージをリストボックスに送る。 

DlgDirSelectComboBox WI 数は、 Win32 API 処理ではない。 Win32 ベースのアプリケ 
ーションは DlgDirSelectComboBoxEx 関数を使用する0 
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第 2 章 Win 32 API 




Dialog Box 


CreateDialo 


5 — ドレスダイアログボックス作成 


E 



V C 


HWND CreateDialog ( 

HINSTANCE hlnstcmce ， //アプリケーションインスタンスのハンドル 

LPCTSTR IpTemplate ， //ダイアログボックスのテンプレート名の識別子 

HWND hWndParent , //オーナーウインドウのハンドル 

DLGPROC IpDialogFunc //ダイアログボックスプロシージャのインスタン 

スポインタ 


)； 


パフメータ • hlnstance ダイアログボックステンプレートをむ’欠行" J 能ファイルのある 

モジュールのインスタンスの識別子。 

• IpTemplate ダイアログボックステンプレートの識別子。ダイアログボックス 

テンプレートの名前を指す、 NULL で終わる文字列のポインタ。 
このパラメータがリソース識別子を指定した場合、上位ワード 
は0でなければならない。下位ワードは識別子を含まなければな 
らない。 MAKEINTRESOURCE マクロでこの1め:を作成する。 

• hWndParent ダイアログボックスを所有するウィンドウの識別子。 

• IpDialogFunc ダイアログボックスプロシージャのボインタ。ダイアログボック 

スプロシージャについて詳しくは、 DialogProc 関数を参照する 
こと。 


戻り値 

正帘終了 

ダイアログボックスのハンドル 


異常終了 

NULL 


解説 CreateDialog 関数は、ダイアログボックステンプレートリソースから、モードレスダ 

イアログボックスを作成する。ダイアログボックスを作成するときには 、 Create 
WindowExI 划数が呼び出される。ダイアログボックスプロシージャは WMJNIT 
DIALOG メッセージ ( DS _ SETFONT スタイルが指定された埸合は、 WM_SETFONT 
メッセージ)を受け取り、ダイアログボックスが表示される。ダイアログボックステン 
プレートで WS _ VISIBLE スタイルを指定すれば、ダイアログボックスが表示される。 
CreateDialog 関数は、ダイアログボックスを作成するとすぐに制御を戻す 0 
CreateDialog 関数を使用して作成したダイアログボックスを破棄するには、 
DestroyWindow 関数を使う 。 Windows 95では、般大16,364個までのウィンドウハン 
ドルをサポートしている。 


参 照 CreateDialogIndirect , CreateDialogIndirectParam , CreateDialogParam , CreateWindowEx , 

— Destroy Window ,— DialogBox ，— DialogProc ’ ShowWindow ，— WM _ INITDIALOG , 
—WM SETFONT 
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2.3 ウインドウコントロール 


DefDlgProc 

user 32 .dll 

95 

NT 

ダイアログボックスメッセージ処理 


V C 


V B 


パラメータ 


戻り値 


解説 


参 照 


LRESULT DefDlgProc ( 

HWND hDlg , 

UINT uMsg 、 

WPARAM wParam , 

LPARAM 

)； 


//ダイアログボックスのハンドル 
// メッセージ 

//第1メッセージパラメータ 


IParam // 第 2 メッセージパラメータ 


Declare Function DefDlgProc Lib " user 32 M Alias " DefDlgProcA ” (ByVal hDlg As 
Long , ByVal wMsg As Long，ByVal wParam As Long，ByVal IParam As Long ) As 
Long 

• hDlg ダイアログボックスの識別子。 

• uMsg メッセージ番4を指定する。 

• wParam メッセージにより異なる追加怡報を指定する。 

• IParam メッセージにより異なる追加怙報を指定する。 


メッセージ処理の結果を返す。結果の总味は送られたメッセージにより異なる。 

DefDlgProc 関数は、アプリケーション定義のダイアログボックスクラスに诚するウィ 
ンドウ処理のためのデフオルトメッセージ処理を行う。 

DefDlgProc 関数はダイアログボックスのあらがじめ定義されたクラスのためのウィン 
ドウプロシージャである。アプリケーシヨンの中でダイアログボックスの機能を継承 
する新しいウィンドウクラスを作成するには、この関数を使用しなければならない。 
DefDlgProc 関数は、ダイアログボックスプロシージャ内のメッセージを処理するデフ 
オルトのハンドラとして呼び出されるようなことはない。そのようにして呼び出した 
坳合、実行が再帰的になってしまう。 

DefWindovvProc ， GetClassInfo ， RegisterClass，—WNDCLASS 
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第 2 章 Win32 API リファレンス 


DialogBox 


95 

NT 

モーダルダイアログボックス作成 


V C 


パラメータ 


戻り信 


解脱 


参 照 


int DialogBox ( 
HANDLE 
LPCTSTR 
HWND 
DLGPROC 
)； 


hlnstance, 

IpTemplate, 

HWndParent , 

IpDialogFunc 


// アプリケーションインスタンスのハンドル 
//ダイアログボックステンプレート名のボインタ 
ガ オーナー ウインドウのハンドル 
//ダイアログボックスプロシージャのポインタ 


• nlnstance 


• IpTempiate 


• hWndParent 

• IpDialogFunc 


ダイアログボックステンプレートを含む実行可能ファイルの 
モジュールのインスタンスの識別子。 

ダイアログボックステンプレートの識別子。ダイアログボックス 
テンプレートの名前を指す NULL で終わる文字列を指すポインタ 
か、ダイアログボックステンプレートのリソース識別子を示す牿 
数値である。上位ワードは、0でなければならない。下位ワード 
は識別子を含まなければならない。 MAKE 1 NTRESOURCE マク 
口を使いこの侦を作成する。 

ダイアログボックスを所有するウィンドウの識別子。 

ダイアログボックスプロシージャのボインタ。ダイアログボック 
スプロシージャ につ t 、て 詳し t 、愔報は、 DialogProc コールバック 
関数を参照のこと。 


正常終了 ダイアログボックスを終了時に利用する EndDialog 関数で衍定した 

nResult パラメータび ) j 点 

異常終了 -1 

DialogBox 閲数は、ダイアログボックステンプレートリソースからモーダルダイアログ 
ボックスを作成する。 DialogBox _ 数は、ダイアログボックスプロシージャが 
EndDialog 関数を呼び出してモーダルダイアログボックスを終 r するまで、制御を戻 
さない。ダイアログボックスの作成時には CreateWindowEx 関数が呼び出される〇そ 
の後ダイアログボックスプロシージャは WMJNITD 1 ALOG メッセージ ( DS_SETFONT 
スタイルが指定されているときは WM_SETFONT メッセージ)を受け取り、ダイアロ 
グボックスが表示される。 

Windows 95では、システムが fii 大16,364個のウィンドウハンドルをサポートする。 

— CreateDialog ， CreateWindowEx ， DialogBoxIndirect , DialogBoxIndirectParam，Dialog 
BoxParam ，— DialogProc ，— EndDialog ，— MAKEINTRESOURCE , 

— WM_INITDI ALOG ，— WM_SETFONT 


94 








2.3 ウインドウコントロール 


DialogProc 


95 

NT 

ダイアログボックスメッセージ処理 


V C 


パラメータ 


戻り傕 


解説 


参 照 


BOOL CALLBACK DialogProc ( 


HWND hwndDlg t 

UINT uMsg t 

WPARAM wParam , 
LPARAM IParam 


//ダイアログボックスのハンドル 
//メッセージ 

//第1メッセージパラメータ 
//第2 メッセージパラメータ 


• hwndDlg ダイアログボックスの識別子。 

• uMsg メッセージを指定する。 

• wParam メッセージにより異なる追加怙報を指定する。 

• IParam メッセージにより異なる追加怡報を指定する 0 

WMJN 1 TDIALOG メッセージへの応答の場合を除いて、ダイアログボックスプロシ 
ージャは、メッセージを処理したときは0以外の値を、それ以外のときは0を返さな 
ければならない 。 WM IN 1 TDIAL 0 G メッセージに応答した埸合、ダイアログボック 



スプロシージャは SetFocus 関数を呼び出してダイアログボックスのコントロールの1 


つにフォーカスを設定したときは、0を返されなければならない。それ以外のときは、 
0以外の値を返さなければならない。この場合、ダイアログボックス内のフォーカス 
を与えることのできる最初のコントロールに、システムがフォーカスを設定する。 


DialogProclW 数は、モーダルやモードレスダイアログボックスに送られたメッセージ 
を処理する、アプリケーション定義のコールバック関数である。 

ダイアログボックスプロシージャは、そのダイアログボックスのためにダイアログボ 
ックスクラスが利用されるときだけ使われる。このクラスはデフオルトのクラスであ 
り、ダイアログボックステンプレートで明確にクラスが指定されなかったときに使わ 
れる。ダイアログボックスプロシージャはウィンドウプロシージャに似ているが、必 
要としないメッセージを処理するときに DefWindowProc 関数を呼び出してはならな 
い。不驳なメッセージはダイアログボックスウィンドウプロシージャが内部的に処理 
する。 

DialogProc は、アプリケーション定義の閲数名のプレースホルダである。 


- ♦ CreateDialog ， CreateDialogInairect ， CreateDialogIndirectParam ， CreateDialogParam ， 
DefWindowProc ， DialogBox ， DialogBoxIndirect ， DialogBoxlndirectParam ， 
DialogBoxParam ， SetFocus ，— WM _ INITD 1 AL 0 G 
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第 2 章 Win 32 API リファレンス 



EndDialo 


モーダルダイアログボックス消去 


user32.dll 



NT 


V C EndDialog ( 

HWND hDlg ， // ダイアログボックスのハンドル 

int nResult "戻り値 

)； 

V B Declare Function EndDialog Lib “ user 32” Alias “ EndDialog ” (ByVal hDlg As Long ， 

ByVal nResult As Long ) As Long 

パラメータ • hD l S 破桊される ダイアログボックスの 識別子0 

• nResult ダイアログボックスを作成した関数からアプリケーションに返す彳め:を指 

定する。 

戻り値 


解説 EndDialog 関数は、モーダルダイアログボックスを消去して、ダイアログボックス処 

理を終了しシステムに復帰させる。 

EndDialog 関数は 、 DialogB ox . Dialog Box Param,DiaIogBox Indirect , そして 
DialogBoxIndirectParaml 対数により作成されたダイアログボックスの処理を完 T する 
ときに使う。アプリケーションは EndDialog 関数を、ダイアログボックスプロシージ 
ャ内から呼び出す。ダイアログボックスプロシージャは、 WMJNITD 1 ALOG メッセ 
ージの処理中でも EndDialog 関数を呼び出すことができる 。 WMJNITDIALOG メッ 
セージの処理の途中で呼び出された坳合、ダイアログボックスは表示される前、また 
はフォーカスが設定される前に、消去される。 

EndDialog 閲数は、ダイアログボックスをすぐに破棄するのではなく 、 DialogBoxlW 
数の実行が終了した直後にダイアログボックスを破棄するようシステムに指示するフ 
ラグを設定する。 

参 照 — DialogBox ， DialogBoxIndirect ， DialogBoxIndirectParam ， DialogBoxParam ， 

—WM INITDIALOG 
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2.3 ウインドウコントロール 


GetDialogBaseUnits 

user32.dll 

95 

NT 

ダイアログボックスベース単位取得 


V C LONG GetDialogBaseUnits (); 


V B Declare Function GetDialogBaseUnits Lib ' user 32" Alias " GetDialogBaseUnits '' () As 

Long 


戻り値 

上位ワード 

ダイアログボックスの高さ 


下位ワード 

ダイアログボックスのベース幅 


解脱 GetDialogBaseUnits 閲数は、 Windows がダイアログボックスを作成するときに使うダ 

イアログボックスのベース琳位を返す。 Windows とアプリケーションはこの値を使用 
して、システムフォントの文字の平均幅を扑兗する。返される値は、ダイアログボッ 
クス唞位にスケーリングされる前のダイアログボックスのベース取位を示す。 x 方向 
のダイアログボックス単位は、この関数が返す幅の4分の丨である。 y 方向のダイアロ 
グボックス) H 位は、この関数が返す高さの8分の1である。 

GetDialogBaseUnits I 対数を使用してコントロー ルのさと fcK ピクセル中.位)を決める 
ときには、ダイアログボックス蜞位の fci ( x ) と“さ ( y )、 および保り frt ( IDIgBaseUnits ) 
を以下の公式に代入する。 

( x * LOWORD ( lDlgBaseUnits )) / 4 
( y * HIWORD ( lDlgBaseUnits )) / 8 

以下の公式はアプリケーションでピクセルからダイアログ単位を変換する。 

dialogunitX =( pixelX *4) / baseunitX 
dialogunitY =( pixelY *8) / baseunitY 

ダイアログのベース蜞位が4で割り切れない値のときは、丸め誤差を避けるために、 
m り算の前に適切な定数を掛ける。 

参 照 —MapDialogRect 
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CtrllD 

user 32 .dll 

95 

NT 


ン トロール識別子取得 


パラメータ 


戻り値 


解説 


int GetDlgCtrlID ( 
HWND 

)； 


hwndCtl //コントロールのハンドル 


Declare Function GetDlgCtrllD Lib " user 32" Alias ' GetDIgCtrllD '' (ByVal hwnd As 
Long ) As Long 

• hwndCtl コントロ ー ルの 識別子。 


正常終了 コントロールの識別子 

異常終了 NULL 

たとえば、 ZmTk / Q / パラメータに不正な値がセットされた坳合、この関数は失敗する。 

GetDlgCtrllD 関数は、指定されたコントロールの識別子を返す。この関数は、ダイア 
ログボックス内のコントロールのハンドルだけでなく、任意の子ウィンドウのハンド 
ルも返す。トップレベルウィンドウは識別子を持たないため、 hwndCtl パラメータに 
トップレベルウィンドウを識別するハンドルを指定した場合、 GetDlgCtrllD 関数の戻 
り値は無効になる。 

— CreateWindow ， CreateWindowEx，—GetDlgltem 


GetDIaltem 


、ロールハンドル取得 


user 32 .dll 



NT 


パラメータ 


戻り値 


解説 


HWND GetDlgItem ( 

HWND hDlg ， //ダイアログボックスのハンドル 

int nlDDlgltem f / コン h ロールの識別子 

)； 

Declare Function GetDlgltem Lib " user 32 M Alias " GetDlgltem " (ByVal hDlg As Long , 
ByVal nlDDlgltem As Long ) As Long 

• hDlg コントロールを持つダイアログボックスの識別子。 

• nlDDlgltem 取得するコントロールの識別子を指定する。 


正常終了 

異常終了 


コント ロールの ウインドウノヽンドル 

NULL 


GetDlgltem 関数は、指定されたダイアログボックス内にあるコントロールのハンドル 
を取得する。 
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2.3 ウインドウコントロール 


GetDlglteml 対数は、ダイアログボックスだけでなく、任怠の親ウィンドウと子ウィン 
ドウのペアに対しても使える。子ウィンドウが一意の識別子 ( CreateWindow または 
CreateWindowEx 閲数を使用して子ウィンドウを作成したときに/?パラメータに 
指定された識別子)を持っていれば、 AD / ぎパラメータに親ウィンドウを識別するハン 
ドルを指定すると、 GetDlglteml 対数は子ウィンドウのハンドルを返す c 

参 照 — CreateWindow ， CreateWindowEx ， GetDlgltemlnt，GetDlgItemText 


GetNextDlgGroupItem 

user 32 .dll 

95 

NT 

コン ト ロールハンドル 取得 


V C 


V B 

パラメータ 


HWND GetNextDlgGroupItem ( 

HWND hDlg y //ダイアログボックスのハンドル 

HWND hCtl ， //コントロールのハンドル 

BOOL bPrevious //方向フラグ 

)； 

Declare Function GetNextDlgGroupItem Lib " user 32” Alias " GetNextDlgGroupItem " 
(ByVal hDlg As Long , ByVal hCtl As Long，ByVal bPrevious As Long ) As Long 

• hDlg 検索されるダイアログボックスの識別子。 

• hCtl 検索の開始配 1 R にあるコントロールの識別子。このパラメータが 

NULL のとき、この関数は検索の開始配趵としてダイアログボック 
スの W 後(または敁初)のコントロールを使う。 

• bPrevious ダイアログボックス内のコントロールのグループを閲数がどのよう 

にして検索するかを指定する。このパラメータが TRUE のときは、 
関数はグループ内の前のコントロールを検索する。 FALSE のとき 
は、グループ内の次のコントロールを検索する0 



民り 値 正常終了 コントロールのウィンドウハンドル 

解“兑 GetNextDlgGroupItem 閲数は、ダイアログボックス内のコントロールのグループの範 

囲内で、前(または次)にあるコントロールを検索する。コントロールのグループ範囲 
は、 WS.GROUP スタイルのコントロールから WS_GROUP スタイルを含まない M 後 
のコントロールまでである。 

AC 7/ パラメータがグループ内の最後のコントロールを識別して、 bPrevious パラメータ 
が FALSE のときには、 GetNextDlgGroupItem 閲数はグループ内の M 初のコントロール 
のウィンドウハンドルを返す。 / iCf / がグループ内の敁初のコントロールを識別して、 
WVmwj が TRUE のときには、 GetNextDlgGroupItem 関数はグループ内の W 後のコン 
トロールのウィンドウハンドルを返す。 

参 照 —GetNextDlgTabltem 
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GetNextDlgTabltem 

user 32 .dll 

95 

NT 

コントロールハンドル取得 


V C 


V B 

パラメータ 


戻り値 


解脱 


参 照 


HWND GetNextDlgTabItem ( 

HWND hDlg % // ダイアログボックスのハンドル 

HWND hCtl , //既知のコントロールのハンドル 

BOOL bPrevious //方向フラグ 

)； 

Function GetNextDlgTabltem Lib " user 32" Alias " GetNextDlgTabltem " (ByVal hDlg 
As Long , ByVal hCtl As Long , ByVal bPrevious As Long ) As Long 


• hDlg 検索されるダイアログボックスの識別子。 

• hCtl 検索の開始配置にあるコントロールの識別子。このパラメータが 

NULL のとき、この間数は検索の開始配! H としてダイアログボック 
スの般後（または敁初）のコントロールを使う0 

• bPrevious ダイアログボックスを関数がどのようにして検索するかを指定する。 

この パラメータ が TRUE のときは、№1数はダイアログボックス内の 
前の コントロールを 検索する0 


正常終了 1コントロールのウインドウハンドル 

GetNextDlgTabUem 閲数は、指定されたコントロールに先行する（または後に絞く） 
WS _ TABSTOP スタイルを持つ最初のコントロールのハンドルを取得する。 

— GetDlghem，—GetNextDlgGroupItem 
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IsDialogMessage 

user 32 .dll 

95 

NT 

ダイア ロ グボ ツク スメ ツセー ジ処理 


V C 


V B 

パラメータ 


戻り値 


解説 


参 照 


BOOL IsDialogMessage ( 

HWND hDlg ， //ダイアログボックスのハンドル 

LPMSG IpMsg II メッセージの祸造体のアドレス 

)； 

Declare Function IsDialogMessage Lib " user 32" Alias ' IsDialogMessageA '' (ByVal 
hDlg As Long , IpMsg As MSG ) As Long 

• hDlg ダイアログボックスを識別するハンドル。 

• IpMsg チヱックされるメッセージを含む MSG 構造体のポインタ。 

正常終 f TRUE 

異常終了 FALSE 

関数は、指定されたメッセージが指定されたモードレスダイアログボックスに対する 
ものならば、メッセージを処理する。 

IsDialogMessage はモードレスダイアログボックス用だが、コントロールを含むウイン 
ドウに対して使用すれば、ダイアログボックスと同じキーボード迸択を実現できる。 
IsDialogMessage は、メッセージを処理するとき、キーボードメッセージをチェックし 
て、対応するダイアログボックスの遗択コマンドに変換する。たとえば、タブキーを 
押すと、次のコントロールまたはコントロールのグループが選択される。また、 I キ 
一を押すと、グルーブの次のコントロールが迸択される 3 IsDialogMessage で処理さ 
れたメッセージは、 TranslateMessage 閲数や DispatchMessage 関数に渡してはならな 
い。これは、必要なメッセージの変換やディスパッチを IsDialogMessage がすべて実 
行するためである。 IsDialogMessage は、処理するキーを利断するため、ダイアログ 
ボックスプロシージャに WM_GETDLGCODE メッセージを送る 。 IsDialogMessage 
は、ウインドウに DM_GETDEFID メッセージや DM_SETDEFID メッセージを送る坳 
合がある。これらのメッセージは W 1 NDOWS . H へッダーファイルで WMJJSER と 
WMJJSER +1 として定義されているため、同じ値のアプリケーション定義のメッセー 
ジと 衝突す る 可能性が ある。 



— DispatchMessage ，— DM _ GETDEHD ，— DM _ SETDEFID ,— ^ MSG , TranslateMessage , 
—WM GETDLGCODE，—WM USER 
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Rect 

user32.dll 

95 

NT 


ダイアログボックス単位変換 


V C BOOL MapDialogRect ( 

HWND hDIg , // ダイアログボックスのハンドル 

LPRECT IpRect //矩形の構造体のアドレス 

)； 

V B Declare Function MapDialogRect Lib ,, user 32 M Alias " MapDialogRect " (ByVal hDlg As 

Long , IpRect As RECT ) As Long 

パラメータ .hDlg ダイアログボックスの識別子。このダイアログボックスは、ダイアロ 

グボックス作成関数を使 H 1 して作成されたものでなければならない。 

• IpRect 変換されるダイアログボックスの座標を含む、 RECT 構造体のボイ 

ンタ。 


戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


解説 MapDialogRect 間数は、指定されたダイアログボックス単位をスクリーン単位（ピク 

セル）に変換（マップ)する。 

MapDialogRect 閲数は、矩形のダイアログボックス啉位をスクリーン堪位に変換す 
る。ダイアログボックス琳位は、現在のダイアログの基本琳位に相対的に定義され 
る。ダイアログの基本単位は、ダイアログボックステキストに使われるフォントの平 
均文字幅と高さに基づいたものである。以下の公式がこの処理である。 

left =( left * baseunitX ) / 4 
right =( right * baseunitX ) / 4 
top =( top * baseunitY ) / 8 
bottom =( bottom * baseunitY ) / 8 

一般に、ダイアログボックスは System フォントを使うが、リソース定義ファイルで 
DS . SETFONT スタイルを指定することにより、アプリケーションは別のフォントを指 
定することができる。 

參 照 -^ CreateDialog , CreateDialogIndirect , CreateDiaIoginairectParam % CreateDialogParam , 

— DialogBox ， DialogBoxIndirect ， DialogBoxIndirectParam ， DialogBoxParam ， 
GetDialogBaseUnits ，— RECT 
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V c 


int MessageBox ( 
HWND 
LPCTSTR 
LPCTSTR 
UINT 


h \ Vnd t // オーナー ウインドウのハンドル 

IpText ， //メッセージボックスのテキストのアドレス 

IpCaption , //メッセージボックスのタイトルのアドレス 
uType //メッセージボックスのスタイル 


V B 


パラメータ 


Declare Function MessageBox Lib M user 32” Alias ' MessageBoxA 11 (ByVal hwnd As 
Long，ByVal lpText As String , ByVal IpCaption As String , ByVal wType As Long ) As 
Long 


hWnd 

lpText 

IpCaption 


uType 


作成するメッセージボックスの所有ウィンドウの識別子。このパラメ 
一夕が NULL のときは、メッセージボックスに所有ウィンドウはない。 
表示されるメッセージを指定する NULL で終わる文字列のポインタ。 
ダイアログボックスのタイトルを指定する NULL で終わる文ネ列のポ 
インタ。このパラメータが NULL のときは、デフオルトタイトルの[エ 
ラー】が使われる。 

ダイアログボックスの内容と動作を指定する。このパラメータは、以 
下の値の組み合わせになる。 


MB_ABORTRETRYIGNORE 


MB APPLMODAL 


MB DEFAULT DESKTOP ONLY 


MB DEFBUTT 0 N 1 


MB _ DEFBUTTON 2 
MB _ DEFBUTT 0 N 3 
MB DEFBUTTON 4 


总味 _ 

メッセージボックスには、【中 ||: J 、 [再試行】、[無祝]の 
3つのプッシュボタンが含まれる。 

ユーザーは、 / iVVrn / パラメータが識別するウィンドウ内 
で作龙を継校する前に、メッセージボックスに化答し 
なければならない。しかし、ユーザーは、ほかのアブ 
リケーシヨンのウィンドウに柊勅し、そのウィンドウ 
内で作龙することができる。 MB.S YSTEM 
MODALMB _ TASKMODAL を指定しなければ、 
MB _ APPLMODAL がデフォルトである。 

人力を受け取るデスクトッブはデフォルトデスクトッ 
プでなければならない。その他の坳介、この問数は火 
敗する。デフォルトデスクトップは、ユーザーがログ 
オンした後に突行されるアブリケーションである。 

Jti 初のボタンがデフォルトになる 。 MB — DEF 
BUTT 0 N 2、 MB _ DEFBUTTON 3 を衍定しなければ、 
W 初のボタンが常にデフォルトになる。 

2のボタンがデフォルトになる 

3 StJ のボタンがデフォルトになる。 

4 S 目のボタンがデフォルトになる。 



MessaaeBox 


ッ セージ ボックス 作成 


user 32 .dll 



NT 


^ A v^ou 
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MB HELP 


MBJCONASTERISK 

MBJCONERROR 

MBJCONEXCLAMATION 

MBJCONHAND 

MB ICONINFORMATION 


MBJCONSTOP 
MBJCON.WARNING 
MB 一 OK 

MB 一 OKCANCEL 

MB 一 RETRYCANCEL 

MB.RIGHT 

MB.RTLREADING 

MB _ SERVICE_NOTIFICATION 


MB SETFOREGROUND 


MB SYSTEMMODAL 


I Windows 95 では、メッセージボックスにヘルプボタノ 
が加わる。ヘルプボタンか F 1 を押すとヘルプが表示さ 
れる。 

MBJCONINFORMATION と同じ。 

Windows 95では 、 MB JCONH AND と M じに使用され 
る。 

悠唤符アイコンがメッセージボックスに衣ボされる。 
MB_ICONSTOP と同じ。 

円の中に小文字の 「 i 」 があるアイコンがメッセージボ 
ックス内に表示される。 MBJC 0 NQUEST 10 N 疑問符 
のアイコンがメッセージボックス内に表示される。 

「 STOP 」 アイコンがメッセージボックスに表示され 
る。 

Windows 95では、 MBJCONEXCLAMATION と同じ 
に使用される。 

メッセージボックスには、 [ OKI プッシュボタンが含ま 
れる。 

メッセージボックスには、 [ OK ] プッシュボタンと[キヤ 
ンセル】プッシュボタンが含まれる。 

メ ッ セージ ボックスには、[再試行】プッシュボタンと 
[キャンセル] プッシュボタンが含まれる。 

Windows 95では、テキストの右詰め。 

Windows 95では、へブライ A 1 やアラビア語で使 Hi され 
る右から左へ説むテキストのメッセージを表示。 

WindowsNT では、イベントをユーザーにサービス通知 
する0カレントデスクトップにメッセージボックスを表 
示する。コンピュータにユーザーがログオンしていなく 
ても同様。このフラグがセットされると、 ZiVVm / パラメ 
ータは NULL でなければならない。これにより、メッ 
セージボックスは/ iVVm / に対応するデスクトップと別の 
デスクトップに表示できる0 

メッセージボックスが前面のウィンドウになる。 
Windows は、メッセージボックスのため SetForeground 
Window 関数を呼ぶ。 

すべてのアプリケーションは、 ユーザーが メッセージボ 
ックスに応答するまで中断される。アプリケーション 
が MBJCONHAND を指定しなければ、メッセージボ 
ックスは、作成されてからモーダルになる。このため、 
親ウィンドウやそのほかのウィンドウは、メッセージボ 
ックスのアクティブ化によるメッセージを受け取り続 
ける。システムモーダルメッセージボックスは、すぐ 
に対応を求められるような、 a 大で消在的な危険性の 
ある エラー (たとえば、メモリ不足など)を ユーザーに 通 
知するために使われる。 
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MB TASKMODAL 


MB.YESNO 
MB YESNOCANCEL 


/ iVVm / パラメータが NULL のとき、 fli / f •のタスクに诚す 
るすべてのトップレベルのウィンドウが使用不能にな 
ることを除いて、 MB _ APP し MODAL と N じ。呼び出 
し側のアプリケーションやライブラリが使用可能なウ 
ィンドウのハンドルを持たず、ほかのアプリケーシヨン 
を中断せずに现在のアプリケーシヨンのほかのウィン 
ドウへの人力を附土しなければならないときには、こ 
のフラグを使用しなければならない。 

メッセージボックスには、[はい1と[いいえ1の2つのプ 
ッシユボタンが含まれる。 

メッセージボックスには、[はい]、[いいえ1、[キャンセ 
ル1の3つのプッシュボタンが含まれる。 


戻り値 メッセージボックスを作成するためのメモリが不足している場合は、0を返す。それ 

以外の場合は、ダイアログボックスが返した以下のメニュー項目倘の t ゝずれかを返 
す0 


値 

怠味 

IDABORT 

[中止】ボタンが押された。 

IDCANCEL 

[キャンセル] ボタンが押された。 

IDIGNORE 

[無祝】ボタンが W された。 

IDNO 

[いいえ】ボタンが押された。 

IDOK 

[ OKI ボタンが押された。 

IDRETRY 

[再試行】ボタンが娜された。 

IDYES 

[はい]ボタンが押された。 


メッセージボックスに[キャンセル1ボタンがあるとき、 Esc キーまたは[キャンセル]ボ 
タンが拆】されると、 IDCANCEL 侦:を返す。メッセージボックスに|キャンセル】ボタン 
がなければ、 Esc キーを押しても効果はない。 


解 脱 MessageBox 関数は、メッセージボックスウィンドウの作成、表不、操作を行う〇メ 

ッセージボックスには、アプリケーション定義のメッセージとタイトルや、 uType パラ 
メータが示す定義済みのアイコンとプッシュボタンの組み合わせが含まれる。システ 
厶用のメモリが少ないことを示すためのシステムモーダルメッセージボックスを作成 
するときは、 IpText パ ラメータと IpCaption パラメータが指す文字列をリソース ファ イ 
ルから取得してはならない。このような状況でリソースにアクセスすると、リソース 
のロー ドに失敗する可能性がある。 

アプリケーションが MB JCONHAND フラグと MB _ SYSTEMMODAL フラ ク♦を uType 
パラメータに指定して MessageBoxI 対数を呼び出すと、 Windows は、使用可能なメモ 
リ容 m にかかわらず、メッセージボックスをそのまま表示する。これらのフラグが指 
定されると、 Windows はメッセージボックスのテキストの長さを3行に制限する。 
Windows はメッセージボックスにあわせて自動的に行を折り返すわけではないため、 
メッセージ文字列の適当な所に、行を折り返すための改行を入れなければならない。 
ダイアログボックスが存在するときにメッセージボックスを作成するときは、ダイア 
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ログボックスのハンドルを AVVW パラメータとして使用する。 / iVVW パラメータでダイ 
ァログボックス内のコントロールなどの子ウィンドウを識別することはできない。 
Windows 95では、 Wr 大16,364_のウィンドウハンドルをサボートする。 

参 照 FlashWindow , MessageBeep , MessageBoxEx,SetForegroundWindow 


SendDlgltemMessage 

user32.dll 

95 

NT 

メッセージ送信 


V C 


V B 


パラメータ 


戻り値 

解 説 


参 照 


LONG SendDlgItemMessage ( 
HWND hDlg , 
int nIDDIg / tem , 

UINT “ Msg 、 

WPARAM wParam , 
LPARAM IParcim 
)； 


// ダイアログボ ッ クスのハンドル 
//コントロールの識別子 
//送信 メ ッ セージ 
//第1メ ッ セージパラメータ 
//第2 メ ッ セージパラメータ 


Declare Function SendDlgltemMessage Lib M user 32" Alias " SendDlgltemMessageA ” 
(ByVal hDlg As Long，ByVal nIDDIg-Item As Long，ByVal wMsg As Long , ByVal 
wParam As Long，ByVal IParam As Long ) As Long 


• hDlg コントロールを含むダイアログボックスの識別子。 

• nlDDlgltem メ ッセージを受け取る コントロールの 識別子を指定する。 

• uMsg 送信メッセージを指定する。 

• wParam メッセージにより異なる追加怡報を指定する。 

• IParam メッセージにより異なる追加情報を指定する。 

炭り倘は、メッセージ処理の結果を示す。結果の値は送られたメッセージにより異な 
る。 

SendDlgltemMessage 閲数は、ダイアログボックス内のコントロールにメッセージを送 
る。 

SendDlgltemMessage |划数は、メッセージカ％理されるまで制御を戻さない。 
SendDlgltemMessage 閲数の®;作は、指定された コン ト ロールのハンドルを 取得して 
SendMessage 閲数を呼び出すことと同じである。 


SendMessage 
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V C 


BOOL SetDlgItemInt ( 
HWND hDlg ， 


UINT 

BOOL 


nlDDIgltem , 

uValue 9 

bSigned 


//ダイアログボックスのハンドル 
//コントロールの識別子 
//設定する値 

//符号の有無を示すインジケータ 


V B 


ハ•ラメータ 


戻り値 


Declare Function SetDlgltemlnt Lib " user 32 M Alias " SetDIgltemlnt " (ByVal hDlg As 
Long，ByVal nlDDIgltem As Long，ByVal wValue As Long，ByVal bSigned As Long ) 
As Long 

• hDlg コントロールを含むダイアログボックスの識別子。 

• nlDDIgltem テキストを変更するコントロールを指定する。 

• uValue 項目テキストを生成するための幣数値を指定する。 

• bSigned uVa / ue パラメ ータの値が符号付きまたは符号なしのどちらであるかを 

指定する。このパラメータが TRUE のときは、 wl ^ /此は符号はきの値 
になる。このパラメータが TRUE で wVWwe が0未満の値のときは、文 
字列中の W 初の数字の前にマイナス記号が付けられる。パラメータが 
FALSE のときは、“ぬ/狀が符号なしの値になる。 


正常終了 TRUE 

異常終了 FALSE 

詳細なエラー借報は GetLastError _数で取得。 

SetDlgltemlnt 閲数は、 ダイアログボックス 内の指定された コントロールのテキス ト 
を、対応する整数侦で表された文字列に設定する。この関数は、指定された コント 
ロールに WM SETTEXT メッセージを送る。 


GetDlgltemlnt ，— SetDlgltemText ，— WM SETTEXT 


ントロールテキスト設定 


NT 


95 


user 32 .dll 


Itemlnt 


SetDI 


o-o7; v> uv ア □ 1 $ 
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SetDIqltemText 


V c 


V B 


パラメータ 


戻り11 


BOOL SetDlgItemText ( 

HWND hDlg , 

int nlDDlgltem , 

LPCTSTR IpString 

)； 


//ダイアログボックスの ハン ドル 
//コント ロールの 識別子 
//設定するテキスト 


Declare Function SetDlgltemText Lib " user 32" Alias .. SetDlghemTextA " (ByVal hDlg 
As Long，ByVal nlDDlgltem As Long , ByVal IpString As String ) As Long 


hDlg 

nlDDlgltem 

IpString 


コントロールを含むダイアログボックスの識別子。 

テキストを設定するコントロールの識別子。 

コントロールにコピーするテキストを設定する、 NULL で終わる 
文字列へのボインタ。 


正常終了 TRUE 

異常終了 FALSE 

詳細なエラー怡報は GetLastError 関数で取得。 

SetDlgltemText 関数は、ダイアログボックス内のコントロールのタイトルやテキスト 
を設定する。この関数は、指定されたコントロールに WM_SETTEXT メッセージを送る。 


GetDlgltemlnt ， GetDlgItemText ，— SetDlgltemlnt ，— W M_S ETTEXT 
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2.3 ウインドウコントロール 


MessageBoxIndirect 

user32.dll 

95 


メ ッ セージ ボックス 作成 


V C 


V B 


パラメータ 


解 脱 


参 照 


BOOL MessageBoxIndirect ( 
LPMSGBOXPARAMS 


)； 


IpMsgBoxParams II メ ッセージボックスパラメー 

夕のアドレス 


Declare Function MessageBoxIndirect Lib " user 32” Alias M MessageBoxIndirectA ,f 
(lpMsgBoxParams As MSGBOXPARAMS ) As Long 

• lpMsgBoxParams メッセージボックスに表示する惜報を含む MSGBOX 

PARAMS 構造体のポインタ。 

MessageBoxIndirect 閲数は、メッセージボックスの作成、表示、制御を行う。このメ 
ッセージボックスには、アプリケーション定義のメッセージテキストやタイトル、ア 
イコン、ボタンの組み合わせが含まれる 。 Windows 95では、 M 大16,364個のウィン 
ドウハンドルがサポートされる。 


— MSGBOXPARAMS 
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Edit Control 



EditWordBreakProc 


95 

NT 

エディツ トコントロールテキスト 編集 


V c 


パラメータ 


戻り値 


解 脱 


参 照 


int CALLBACK EditWordBreakProc ( 


LPTSTR 

int 

int 

int 


Ipch , // 編集するテキストのポインタ 

ichCurrent , //開始位置 
cch , //編集するテキスト長 

code //取得した アクション 


)； 


• Ipch 編集コントロールのテキストのポインタ〇 

• ichCurrent _数がワードを分けるためにチヱックを開始するポインタ識別子の 

テキストバッファの文字位！ R を指定する。 

- cch 編集コントロールテキストの文字列長を指定する 0 

- code コールバック関数により取得されるアクションを指定する。このパ 

ラメータは、以下の値の1つである。 


値 

アクション 

WBJSDELIMITER 

カレント位 Iff の文字列の限界を検出。 

WB_LEFT 

カレント位趵の左のワードの開始を検出。 

WB.RIGHT 

カレン ト位 n の右のワー ドの開始を検出(これは、編浓コント 


ロールが右詰めであるときに有効)。 


Windows 95では、 S 茁な編集コントロールを定義し、⑺みパラメータに値を加えて 
いる。値のリストについては 、 EM F 1 NDWORDBREAK の記述を照会のこと。 


co みパラメータが WBJSDELIMITER を指定している坳合、カレント位蹬が限界位 
蹬であれ{煩り値は0以外 ( TRUE ) で、そうでない埸合は、0である。その他の坳合は、 
戻り値はテキストバッファのワードの開始インデックスである。 

EditWordBreakProc 関数は、アプリケーション定義のコールバック関数である 0 
ED 1 TWORDBREAKPROC のタイプの値は、 I 划数のポインタである0ラインフィード 
に続くキャリッジリターンは、コールバック_数により単ーワードとされる。2つの 
キャリッジリターンは単ーワードとしてラインフィードに続く。アプリケーションは、 
EM_SETWORDBREAKPROC メッセージでコールバック関数のアドレスを指定され 
ているコールバック関数をインストールしなければならない。 

EditWordBreakProc は、アプリケーション定義の関数名プレースホルダーである。 


SendMessage ，— EM 一 FINDWORDBREAK ，— EM—SETWORDBREAKPROC 
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2.3 ウインドウコントロール 


List Box 


jd 


DlaDirList 

user 32 .dll 

95 

NT 

ファイル名取得 


V C 


V B 


パラメータ 


int DlgDirList ( 



HWND 

hDlg ， 

//リストボックスを持つダイアログボックスの 



ハンドル 

LPTSTR 

IpPathSpec , 

//パス名またはファイル名の文字列のポインタ 

int 

nIDListBox ， 

//リストボックスの識別子 

int 

nIDStaticPath , 

//スタテイックコントロールの識別子 

UINT 

)； 

uFileType 

//表示するファイルの属性 


Declare Function DlgDirList Lib M user 32 n Alias M DlgDirListA M (ByVal hDlg As Long ， 
ByVal IpPathSpec As String，ByVal nIDListBox As Long，ByVal nIDStaticFath As 
Long , ByVal wFileType As Long ) As Long 



• hDlg 

• IpPathSpec 


• nIDListBox 


• nIDStaticPcith 


リストボックスを持つダイアログボックスの識別子。 

パス名またはファイル名を含む、 NULL で終わる文字列を指す 
ボインタ。 DlgDirList はこの文字列を変更することがあるため、 
文字列の領域は変更分を格納するのに十分な大きさでなければ 
ならない。詳しくは、解説を参照のこと。 

リストボックスの識別子を指定する。このパラメータが〇のと 
き、 DlgDirList リストボックスが存在しないものとし、ファイル 
名やディレクトリを格納しない。 

カレントドライブとディレクトリの表示のために使われるスタテ 
ィックコントロールの識別子を指定する。このパラメータが〇の 
とき、 DlgDirList はそのようなコントロールが存在しないものと 
する。 
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- uFileType 表示するファイル名の域性を指定する。このパラメータは、以 

下の値の組み合わせになる。 



説明 

DDL 一 ARCHIVE 

アーカイブファイル0 

DDL.DIRECTORY 

サブディレクトリ。サブディレクトリは角括弧（⑴で括られる。 

DDL.DRIVES 

ドライブ。ドライブは卜 X -] の形式でリストされる。 X は、ドラ 


イブ文字である。 

DDL 一 EXCLUSIVE 

俳他 ビット。この 排他 ビットをセットすると、指定されたタイ 


プのファイルだけが表示される。そうでないときは、指定され 


たファイルだけでなく通常のファイルもすベて表示される。 

DDL_HIDDEN 

しファイル。 

DDL . READWR 1 TE 

ほかの W 性を持たな t 、説み,* f き可能なデータファイル。 

DDL 一 READONLY 

読み取り舆用ファイル。 

DDL 一 SYSTEM 

システムファイル。 

DDL 一 POSTMSGS 

アプリケーションメッセージキューにボストメッセージを送る。 


デフォルトは、ダイアログボックスプロシージャに ift 接メッセー 


ジを送る。 


戻り値 

リストが作成された埸合 

0以外 


検索パスに入力文字列を含む値がない埸合 

0 


解 脱 DlgDirList 関数は、指定されたパス名またはファイル名と一致するすべてのファイル 

名をリストボックスに格納する。 

IpPathSpec パラメータに長さが0の文字列を指定したとき、またはファイル名を含ま 
ないディレクトリ名だけを指定したときには、文字列が*.*に変更される。 

IpPathSpec パラメータの形式は以卜の通り 0 

[ drive :】[[\ u 】 directorv [\ idirectory 】\ u】[filenamel 
drive はドライブ名、 directory は有効なディレクトリ名、 filename は少なくとも1つの 
ワイルドカー R ? or *) を含む有効なファイル名である 0 

IpPathSpec パラメータに ドライブ名やディレクトリ名、またはその両方を指定したと 
きは、リストボックスに格納する前にカレントドライブとカレントディレクトリが指 
定のドライブとディレクトリに変更される。 n / DSujticPat / i パラメータの識別子のスタ 
ティックコントロールについても、ドライブ名やディレクトリ名が新しいものに更新 
される。 

IpPathSpec パラ メータのパス名とファイル名がリストボックスに格納されると、ドラ 
イブ名やディレクトリ名の部分が削除されて、 IpPathSpec パラメータが更新される 0 
DlgDirList 関数は、 LB_RESETCONTENT メッセージと LB.DIR メッセージをリスト 
ボックスに送る0 

参照 — DlgDirListComboBox ， DlgDirSelectComboBoxEx ，— DlgDirSelectEx 
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2.3 ウインドウコントロール 


DlgDirSelectEx 

user32.dll 

95 

NT 

リストボックス選択項目取得 


V CKI BOOL DlgDirSelectEx ( 

HWND hDlg ， //リストボックスを持つダイアログボックスのハンドル 

LPTSTR IpString , //ノ 、。ス 名の文字列ノ 《ッ ファへのポインタ 

int nCount , //パス名の文字列のバイト数 

int nlDUstBoxll リストボックスの識別子 

)； 


V B 


パラメータ 


Declare Function DlgDirSelectEx Lib u user 32 M Alias " DlgDirSelectExA " (ByVal 
hWndDlg As Long , ByVal IpszPath As String , ByVal cbPath As Long , ByVal 
idListBox As Long ) As Long 


• hDlg リストボックスを持つダイアログボックスの識別子。 

• IpString 逍択されたパス名またはファイル名を受け取るバッファへのボイ 

ンタ〇 

• nCount IpString パラメータが指すパス名またはファイル名の長さ(バイト增 

位)を指定する。 

• nlDListBox ダイアログボックス内のリストボックスの識別子を表す幣数を指定 

する。 


戻り値 

迸択項目がディレクトリ名 

0以外 


それ以外 

0 


詳細エラー怡報は、 GetLastError 関数で取得。 


解 脱 DlgDirSelectEx 閲数は、単一迸択のリストボックスのカレントで进択されている項目 

を取得する。指定されたリストボックスには、 DlgDirList 関数を使用してデータを格 
納しておく。迸択項目は、ドライブ名、ファイル名、またはディレクトリ名として処 
理される。カレントに遴択されている項目がディレクトリ名またはドライブ名のとき、 
DlgDirSelectBoxEx は、それらの名前から角括弧やハイフンを取り除いて、新しいパ 
ス名に挿入できるようにする。何も逭択されていないときには、 IpString パラメータ 
の内容は変わらない。 

DlgDirSelectEx 関数は、 LB.GETCURSEL メッセージと LB_GETTEXT メッセージを 
リストボックスに送る。 

DlgDirSelectEx 閲数を使用して、リストボックスから1つ以上のファイル名を返すこ 
とはできない。複数選択のリストボックスではこの関数は使えない。使用した埸合、 
この_数は0を返さず、 IpString パラメ —夕の指す文字列は変更されない。 



参照 — DlgDirList ，— DlgDirListComboBox ， DlgDirSelectComboBoxEx ，— LB 一 GETCURSEL ， 

— LB GETTEXT 
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EnableScrollBar 

user32.dll 

95 

NT 

スクロールバー 状態設定 


V C 

V B 

パラメータ 


BOOL EnableScrollBar ( 

HWND hWnd , // ウィンドウまたはスクロールバーのハンドル 

UINT wSBflags , //スクロールバータイプのフラグ 

UINT wArrows //スクロールバー矢印フラグ 

)； 


Declare Function EnableScrollBar Lib M user 32" Alias " EnableScrollBar ” (ByVal hwnd 
As Long，ByVal wSBflags As Long，ByVal wArrows As Long ) As Long 


• hWnd wS £(/7 a 私パラメータの fift に応じた、ウインドウまたはスクロールバーコ 

ントロールの識別子。 

• wSBflags スクロールバーのタイプを指定する。このパラメータは、次の値-のいず 

れかになる。 


蛸 


意味 


SB BOTH 


SB CTL 


SB HORZ 


SB VERT 


指定された ウィンドウの 水平および联 スクロールバーの 矢印を使用" I 能ま 
たは使用不能にする。 / wm / パラメータは ウインドウのハン ドルになる。 

スクロー ルバーをスクロールノ くーコントロールとして識別する。 hwnd バラメ 
ータはスクロールバーコントロールのノ、ンドルになる。 

指定された ウィンドウの 水平 スクロールバーの 矢印を、使吋能または使用 
不能にする。 / wm / パラメータはウインドウのハン ドルになる。 

指定され たウィンドウの* 治; スクロールバーの 矢印を、使 HI 可能 または 使用 
不能に する。 /rnvd パラメータはウインドウのハンドルになる。 


• wArrows スクロールバーの矢印の使用可能または使用不能、および使用可能 

または使用不能にする矢印を指定する。このパラメータは、次の 
値のいずれかになる。 
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2.3 ウインドウコントロール 


値 

意味 

ESB 一 DISABLE_BOTH 

スクロールバーの両方の矢印を使用不能にする 0 

ESB_DISABLE 一 DOWN 

垂直スクロールバーのド矢印を使用不能にする。 

ESB_DISAB し E _ し EFT 

水平スクロールバーの左矢印を使用不能にする。 

ESB 一 DISABLE 一 LTUP 

水 t •スクロールバーの左矢印か、琚也•スクロールバーの上矢印 


を使⑴不能にする。 

ESB _ DISABLE_RIGHT 

水平スクロールバーの右矢印を使用不能にする。 

ESB _ DISABLE_RTDN 

水平 スクロールバーの 右矢印 か、 垂直 スクロールバーの 下矢印 


を使用不能にする。 

ESB _ DISABLE_UP 

垂直 スクロールパーの t 矢印を使用不能にする。 

ESB_ENAB し E 一 BOTH 

スクロール/、•一の闽力•の矢印を使川可能にする。 


戻り値 

指定通りに状態が変史された場合 

TRUE 


すでに獎求状態もしくは エラー 

FALSE 

解 説 

EnableScrollBarlW 数は、 スクロールバーの矢印の 片方または阀方を、使用可能また 
は使用不能にする。 

参 照 

—ShovvScrollBar 



GetScrollPos 

user32.dll 

95 

NT 

スクロールボックス 位置取得 


V C int GetScrollPos ( 

HWND hWnd t // スクロールバー 付きの ハン ドルのウ イン ドウ 

int nBar // スクロールバーフラグ 

)； 

V B Declare Function GetScrollPos Lib " user 32" Alias " GetScrollPos " (ByVal hwnd As 

Long , ByVal nBar As Long ) As Long 

パラメータ • hWrul スクロールバーコントロール または挖准 スクロールバーを持つウイン 

ドウの識別子。これは、肋 r パラメータの侦に依存する。 

• nBar 調査するスクロールバーを指定する。以下の値のいずれかになる。 


Vi . 

总味 

SB 一 CTL 

スクロールバーコントロールの位听を取以する。 / m ， m / パラメータはスクロ 


ールバーコントロールのウインドウハンドルになる。 

SB.HORZ 

ウィンドウの水平スクロールバーの位! i v (を取 fl # する。 

SB.VERT 

ウィンドウの Sift スクロールバーの位押を取得する。 
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戻り値 

正常終了 

スクロールボックスのカレン ト位蹬 


異常終了 

0 


詳細なエラー情報は、 GetLastError 関数で取得。 

解 説 GetScrollPos 閲数はスクロールバーのスクロールボックス(つまみ)のカレント位置を取 

得する。カレント位餺は、カレント スクロール 範囲に依存する相対的な値になる。た 
とえば、 スクロール 範囲が0から100であり、 スクロールボックスがバーの 中央にある 
ときは、カレント位置は50となる。 

GetScrollPosI 划数は、32ビットスクロール位 [ H をアプリケーションが使えるようにす 
る。 WH _ HSCROLL や WMJVSCROLL メッセージのように、スクロールバーの位置 
を示すものは、位置データの16ビットが限界である。 SetScrollPos、SetScroll Range 、 
GetScrollPos 、 GetScrollRange 関数は 32 ビットのスクロールバーの位 IS データをサポ 
一卜する。それで、アプリケーションは WM _ HSCROLL や WM — VSCR 0 LL メッセー 
ジの処理中に32ビットスクロールバー位蹬データを得て、 GetScrollPos を呼ぶことが 
できる。 

このテクニックが利用できるのは、ウィンドウ コン トロールでのスクロールの実時間 
内である。アプリケーションが WM _ HSCROLL や WM_VSCROLL メッセージを処理 
することにより、スクロールボックスの 位置を 追ったり、ユーザーが 勤 かす問つまみ 
に知らせる、 SB _ THUMBTRACK 通知メッセージを伝え、スクロールを行う。ユー 
ザーが動かす問に、つまみの32ビット位蹬を 検出す る関数はない。 GetScrollPos はス 
タティック位趵データのみ用总する。アプリケーションはスクロールが 場所を 得た前 
後では、32ビット 位置 データを 取得す ることだけできる。 

参照 — GetScrollRange ，— ScrollDC，—Scroll Window ，— SetScrollPos ，— SetScrollRange , 

— WM _ HSCROLL ，— WM 一 VSCROLL 


GetScrollRange 

user32.dll 

95 

NT 

スクロールバー 最小値最大値取得 


V C BOOL GetScrollRange ( 


HWND 

hWnd , 

int 

nBar ， 

LPINT 

lpMinPos ， 

LPINT 

lpMaxPos 

)； 



// スクロールバー 付きのウインドウの ハン ドル 
//スクロールバー フラグ 
//位趵の敁小値の取得 ァドレス 
//位 Iff の M 高値を取得 アドレス 


V B Declare Function GetScrollRange Lib " user 32 M Alias " GetScrollRange •’ (ByVal hwnd 

As Long , ByVal nBar As Long，lpMinPos As Long , lpMaxPos As Long ) As Long 
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2.3 ウインドウコントロール 


パラメータ 


戻り値 


解 説 


参 照 


• hWnd スクロール バー コントロール または標準 スクロールバーを 持つウインド 

ゥの識別子。これは、 Mar パラメータの値に依存する。 

• nBar どの スクロールバーを 取得するかを指定する。この パラメータは 以下の 

値のいずれかになる。 


値 

意味 

SB 一 CTL 

スクロールバーコントロールの 範 を取得する。 / mTu / パラメータはスクロ 


ールバーコントロールのハンドルである。 

SB.HORZ 

ウィンドウの 水平 スクロールバーを 取得する。 

SB.VERT 

ウィンドウの 垂商 スクロールバーを 取得する。 


• IpMinPos : 

• IpMaxPos 

位蹬の tel 小値を受け取る幣数値の変数を指すボインタ。 

:位置の最大値を受け取る整数値の変数を指すポインタ。 

正常終了 

異常終了 

TRUE 

FALSE 


詳細なエラー情報は、 GetLastError 関数で取得。 

GetScrollRange 関数は、指定された スクロールバーのカレントスクロールバー位置の 
敁小値と M 大値を取得する。指定された ウィンドウが、 標準 スクロールバーを 持たな 
いと き やスクロールバーコントロールでないと きには、 GetScrollRange 関数は 
IpMinPos パラ メータと IpMaxPos パラ メータに〇をコピーす る。標準 スクロールノく一の 
デフオルトの 範囲は0 から 100までである。 スクロールバーコントロールのデフオルト 
の 範囲は空 (両方の 値が 0) である。 

WM _ HSCROLL や WM_VSCROLL メッセージの ように、 スクロールバーの 位阎を示 
すものは、位置 データの 16ビットが限界である。 SetScrollPos 、 SetScrollRange 、 
GetScrollPoSx GetScrollRange _ 数は32 ビットのスクロールバーの 位!0: データ をサボ 
一 卜する。 WM _ HSCROLL や WM_VSCROLL メッセージの ため、16 ビットの 障宵を 
逃れる方法はある。その テクニックの 説明は、 GetScrollPos 閲数を照会のこと。 



— GetScrollPos ，— SetScrollPos ，— SetScrollRange ，— WM _ HSCROLL ， 
—WM VSCROLL 
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ScrollDC 

user32.dll 

95 

NT 

矩形領域スクロール 


V C 


V B 


パラメータ 


戻り値 


Scroll DC ( 

HDC 

int 

int 

CONST RECT 
CONST RECT 
HRGN 
LPRECT 

)； 


hDC ， // デバイスコンテキストのハンドル 

dx t //水平スクロール贵 

dy , //垂直スクロール M 

* lprcScroll t // スクロー ル 矩形の アドレス 
VprcClip , // ク リッピ ング 矩形の アドレス 
hrgnUpdate , //スクロールリージヨンのハンドル 
IprcUpdate //史新矩形の構造体の アドレス 


Declare Function Scroll DC Lib M user 32" Alias ' ScrollDC '' (ByVal hdc As Long , ByVal 
dx As Long , ByVal dy As Long , IprcScroll As RECT , IprcClip As RECT , ByVal 
hrgnllpdate As Long , IprcUpdate As RECT ) As Long 


• hDC 

• dx 

• dy 

• IprcScroll 

• IprcClip 

• hr^n Update 

• IprcUpdate 


スクロール する ビッ トを含むデバイスコンテキストの識別子。 

水平方向のスクロール贷を指定する。このパラメータは、左へのス 
クロール値は負の数で指定する。 

垂截方向のスクロール W を指定する。このパラメータは、上へのス 
クロール fl 叙は負の数で指定する。 

スクロール する矩形の座標を設定する、 RECT 構造体のボインタ。 
クリッピング矩形の座標を設定する、 RECT 構造体のポインタ。デ 
バイスビットはクリッビング矩形に削り当てられる。この構造体に 
は、 IprcScroll パラメ ータが指す元の矩形よりもこの矩形が小さいと 
きは、小さいほうの矩形の中だけでスクロールが行われる。 

スクロール 処理により画面上に現れるリージョンの識別子。 
ScrollDC 間数はこのリージョンを定義するが、必ずしも矩形である 
とは限らない。 

スク ロールに より史新されたリージョンを阁む矩形の座標を受け取 
る RECT 構造体のポインタ。このリージョンは、再描闽が必费な极 
大の妬形領域である。この構造体に格納される値は、デバイスコン 
テキストのマッピングモードにかかわらず、つねにクライアント座 
標になる。アプリケーションは、必要なときに更新リージョンを使 
用して InvalidateRgn I 对数を呼び出すことができる。 


lK 常終了 TRUE 

輿常終了 FALSE 

詳細なエラー怡報は、 GetLastError I 対数で取得。 
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2.3 ウインドウコントロール 


解 説 ScrollDC 関数は、矩形領域のビットを垂直方向および水平方向にスクロールする。 

IprcUpdate パラメ ータが NULL のとき、 Windows は更新矩形の座標を計算しない。 
hrgnUpdate パ ラメータと Iprcilpdate パ ラメータがいずれも NULL のときには、 
Windows は更新リージョンを計算しない。/びがが NULL でなければ、 
Windows は、スクロール処理により表に出るリージョンの有効なハンドル (ScrollDC 
関数で定義)が、パラメータに設定されているものと仮定する。ウィンド 
ウのクライアント領域全体をスクロールする必要があるときは ScrollWindow 閲数を使 
い、それ以外のときは ScrollDC 関数を使う 0 

参 照 InvalidateRgn ，— RECT ，— Scroll Window 


ScrollWindow 

user32.dll 

95 

NT 

クライアント領域 スクロール 


V C 


V B 


パラメータ 


BOOL ScrollWindow ( 


HWND 

int 


hWnd , 

XAmount , 
YAmount , 


CONST RECT * lpRect f 
CONST RECT VpClipRect 
)； 


// スクロールするウインドウのハンドル 
//水平スクロール墩 
//垂直スクロール 

//スクロール 矩形の構造体のアドレス 
//クリッビング矩形の構造体のアドレス 


Declare Function ScrollWindow Lib “ user 32” Alias “ ScrollWindow ” (ByVal hWnd As 
Long，ByVal XAmount As Long，ByVal YAmount As Long，IpRect As RECT , 
lpClipRect As RECT ) As Long 

• hWnd スクロールするクライアント領域のウィンドウの識別子。 

• XAmount 水平スクロール量をデバイス単位で指定する。 CS_OWNDC または、 

CS _ CLASSDC スタイルでスクロールする埸合は、このパラメータはデ 
バイス単位より論理琳位を使う。左にスクロールするときは、このパラ 
メータに負の値を指定する。 

• YAmount 垂直スクロール W をデバイス単位で指定する。 CS _ OWNDC または、 

CS _ CLASSDC スタイルでスクロールする場合は、このパラメータはデ 
バイス単位より論理単位を使う。上にスクロールするときは、このパラ 
メータに負の値を指定する。 

• IpRect クライアント領域内のスクロールする部分を指定する RECT 構造体のポ 

インタ。このパラメータが NULL のときは、クライアント領域全体がス 
クロールされる。 

•lpClipRect スクロールするときのクリッピング矩形を指定する、 RECT 構造体のポ 

インタ。スクロールされるビットはこの矩形内のビットだけで、矩形外 
のビットはスクロールされない。 
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戻り値 正常終了 TRUE 

異常終了 FALSE 

詳細なエラー怡報は、 GetLastError 関数により取得すること。 

解 説 Scroll Window 関数は、ウィンドウのクライアント領域の内容をスクロールする。スク 

ロール時にウィンドウ内にキヤレットがあるときには、 ScrollWindow はキヤレットを 
自動的に非表示にして消去されないようにし、スクロールが終了した後でキヤレット 
を復元する。キヤレットの位置は適切に調整される。 

ScrollWindow |划数により表に出る領域は再描画されないが、ウィンドウの更新リー 
ジョンの中に含めらる。アプリケーションは、領域の W 描画が必要であることを通知 
する WM _ PA 1 NT メッセージを後で受け取る。表に出る領域をスクロールと同時に再 
描画するには、 ScrollWindow 関数を呼び出した直後に UpdateWindowlW 数を呼び出 
す。 

IprcScmll パラメータが NULL のとき 、スクロールされたウインドウの子ウインドウの 
位置は、 練 パラメータとパラメータの分 だけ相対的に移動し、 ウイン 
ドウ 内の無効な(描画されていない)領域も移®;する。 このと きには ScrollWindow の実 
行が高速になる。 

IprcScra // パラメータが NULL でないときには、子ウィンドウの位! H は変更されず、ウ 
ィンドウの無効領域も移動しない。 / p /? ecf に NULL を指定しない場合には、更新の問 
題を避けるため、 ScrollWindow 関数を呼び出す前に UpdateWindow 関数を呼び出し 
てウィンドウを再描画する。 

参照 — RECT ，— ScrollDC’Scroll WindowEx，UpdateWindovv 
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2.3 ウインドウコントロール 


SetScrollPos 

user 32 .dll 

95 

NT 

スクロールボックス位置設定 


V C 


V B 


パラメータ 


戻り値 


int SetScroIlPos ( 


HWND 

hWnd . 

int 

nBar ， 

int 

nPos ， 

BOOL 

bRedraw 


//スクロールバーを 持つウインドウのハンドル 
//スクロールバー フラグ 
//スク ロール ボックスの新し t 、位 is 
//再描画 フラグ 



Declare Function SetScrollPos Lib " user 32" Alias " SetScrollFos " (ByVal hwnd As 
Long , ByVal nBar As Long , ByVal nPos As Long，ByVal bRedraw As Long ) As Long 


• hWnd 設定するスクロールバーを持つウィンドウの識別子。 

- nBar 設定するスクロールバーを指定する。この■は、以下のいずれかになる 0 



意味 

SB_CTL 

スクロールバー内のスクロールボックスの位 矜を設定する。 このと き、 


パラメータはスクロールバーコントロールのハンドルである。 

SB.HORZ 

ウィンドウの標準水平スクロールバーのスクロールボックスの位 1 T (を1设定 


する。 

SB 一 VERT 

ウインドウの標堆垂 ift スクロールバーのスクロールボックスの位; W を設定 


する。 


• nPos スクロールボックスの 新しい位餺を指定する。その位趵は、 スクロールの 

範181内になければならない。詳細なスクロール範朗の怙報は、 
SetScrollRange 閲数で取得する 0 

• bRedraw スク ロールボックスの新し t 、位搜を反映してスクロールバーを再描画する 

かどうかを指定する。この パラメータ が TRUE のときはス クロールバーが 
再描画され、 FALSE のときは再描画されない。 


正常終了 スクロールボックスの 以前の位稃 

異常終了 0 

詳細なエラー情報は、 GetLastError 関数で取得する〇 
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解 説 SetScrollPos 関数は、スクロールボックス(つまみ)のカレント位置を設定する。オプシ 

ョンが指定されているときは、新いゝ位置を反映してスクロールバーを再描画する0 
SetScrollPos 閲数は、 Windows 3. x •の Win 32 ベースを適合条件とする。ほかの関数を 
続けて呼び出すことによりスクロールバーが冉描画されるときは、 つねに bRedraw パ 
ラメータに FALSE を設定しておくと便利である。 

WM_HSCROLL や WMJVSCROLL メッセージのように、スクロールバーの位蹬を示 
すものは、位 [ W データの16ビットが限界である。アプリケーションは SetScrollPosI 対 
数の，! /V パパラメータに M 大65,535の値を持つ位趵データのメッセージを当てにするだ 
けである。 

SetScrollPos 、 SetScrollRange 、 GetScrollPos 、 GetScrollRange _ 数は32ビットのスク 
ロールバーの位趵データをサボートする。 WM _ HSCROLL や WMJVSCROLL メッセ 
ージのため、16ビットの陣害を逃れる方法はある。そのテクニックの説明は 、 Get 
ScrollPos 関数を照会のこと。 

參 照 — GetScrollPos ，— GetScrollRange ，— ScrollDC,—Scroll Window，—SetScrollRange 


SetScrollRanae 

user32.dll 

95 

NT 

スクロールバー最小値最大値設定 


V C BOOL SetScrollRange ( 


HWND 

hWnd , 

" スクロールバーを持つウインドウのハンドル 

int 

nBar , 

" スクロールバーフラグ 

int 

nMinPos , 

//スクロール位蹬の W 小値 

int 

nMaxPos , 

//スクロール位蹬の敁大値 

BOOL 

bRedraw 

//再描画フラグ 


V B Declare Function SetScrollRange Lib " user 32" Alias " SetScrollRange ” (ByVal hwnd As 

Long , ByVal nBar As Long，ByVal nMinPos As Long，ByVal nMaxPos As Long ， 
ByVal bRedraw As Long ) As Long 

パラメータ - hWnd ウインドウまたはスクロールバーの識別子。このパラメータに指定する 

做は、 nBar パラメータの値.による。 

- nBar 設定するスクロールバーを指定する。このパラメータの値は、以下のい 

ずれかになる。 


Vi . 

意味 

SB_CTL 

スクロールバーの 範的! を 設定する。このとき、 / iVVm / パラメータはスクロー 


ルバーのハンドルでなけれ if ならない。 

SB 一 HORZ 

ウインドウの 水平 スクロールバーの 範囲を設定する。 

SB.VERT 

ウインドウの 垂 iA ； スクロールバーの 範囲を•没定する。 
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2.3 ウインドウコントロール 


• nMinPos スクロール位! S の最小値を指定する。 

• nMaxPos スクロール位置の最大値を指定する。 

• bRedraw 位 IS の変吏を反映して スクロール バーを再描画するかどうかを指定 

する。この パラメータ が TRUE のときは スクロールバー が再描画さ 
れ、 FALSE のときは再描画されない。 


戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


詳細なエラー怡報は、 GetLastError 関数で取得。 

解 説 SetScrollRange 関数は、指定されたスクロールバーの W 小位}«と W 大位蹬の値を設定 

する。また、標準 スクロール バーを非表示にしたり、表示したりする。アプリケー シ 
ョンでスクロールバー 通知メ ッセージを 処理している問は、この関数を呼び出して ス 
クロールバーを 非表示にしてはな ら ない。 

SetScrollPoslJy 数の直後に SetScrollRange 関数を呼び出すときには、 スクロールバー 
が 2回描_されないように、 SetScrollPos の パラメータに 0を設定す る。 標準 
スクロールバーのデフオルトの 範囲は 〇〜1〇〇である。スクロールバーコントロールの 
デフ オルトの 範囲は 空で あるおよび/ zAf の:/^ *5 の値は⑴〇 と 

nMaxPos < T > 各バラ メータ に指定す る 値の差は、 MAXLONG の値以下でなければなら 
ない。 

WM—HSCROLL や WMJVSCROLL メッセージのように、スクロールバーの位蹬を示 
すものは、位岡 データの 16ビットが 限界で ある。 アプリケーションは SetScrollPos 関 
数の，! Pay パラメータに 般大65,535 の 値を持つ位 趵データのメッセージを 当てにする だ 
けである。 

SetScrollPos 、 SetScrollRange 、 GetScrollPos 、 GetScrollRange 閲数は32ビットのスク 
ロールバーの 位 [g データを サ ポー トする。 WM_HSCROLL や WM_VSCROLL メッセ 
ージのため、16ビットの障害を逃れる方法はある。その技術および限界の説明は、 
GetScrollFos 閲数を照会のこと。 

参照 — GetScrollPos ，— GetScrollRange ，— SetScrollPos 
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ShowScrollBar 

user32.dll 

95 

NT 

スクロールバー 表示状態設定 


V C 


BOOL ShowScrollBar ( 

HWND h \ Vnd t 

int wBar y 

BOOL bShow 

)； 


// スク ロール バーを持つウインドウのハンドル 
//ス クロールバー フラグ 
//スク ロール バー表示フラグ 


V B 


パラメータ 


Declare Function ShowScrollBar Lib " user 32" Alias " ShowScrollBar " (ByVal hwnd As 
Long , ByVal wBar As Long , ByVal bShow As Long ) As Long 

• hWnd vv & び パラメータの値に より、 スクロールバーのコントロールの 識別子、 

または標準スクロールバーを持つウインドウの識別子。 

• wBar 表示または非表示のスクロールバーを指定する。このパラメータは、以下 

ののいずれかになる。 



总味 

SB 一 BOTH 

ウィンドウの R 準の水 f ■方向と方向のスクロールバーを表示または非 


表示。 

SB.CTL 

スクロールバーを衣ボまたは非ぶ示にする。パラメータは、スクロー 


ルバーコントロールのハンドルとする。 

SB 一 HORZ 

ウィンドウの挖咿水、ドスクロールバーを 表示 または非 表示。 

SB.VERT 

ウィンドウの榡咿垂スクロールバーを 表示 または非在 示。 


• bShow スクロールバーを表示するか非表示にするかを指定する 0 このパラメータ 
が TRUE の埸合はスクロールノ、•一が表示され、それ以外の場合はスクロー 
ルバーが非表示になる。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怡報は、 GetLastError 閲数で取得 0 


解 説 ShowScrollBar 関数は、スクロールバーを表示したり非表不にしたりする。アブリケ 

ーションでスクロールバー通知メッセージを処理しているときに、この関数を呼び出 
してスク ロール バーを非表示にしない。 


参 照 


— GetScrollPos ，— GetScrollRange ，— ScrollDC，—Scroll Window ，— SetScrollPos ， 
— SetScrollRange 
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2.4 シェル 


2. 4 Shell Features 

シェル 

ファイルのインストール、スクリーンセイバーととシェル操作に関する API 
関数群が含まれる0特に、ファイルインストール関数に関しては、非常に重 
要な役割を担う部分である0また、各アプリケーションから別のァブリケー 
シヨンを実行したり、作成された文書に対する操作などもする操作などもシ 
エル関数を利用する0 


Control Panel 


CPIApplet 


ールパネルアブリケーシ 


■DC 

• ■ 


ントリポインタ 



v c LONG APIENTRY CPIApplet 

HWN hwndCPL //コントロールパネルウィンドウのハンドル 

UINT uMsg ， //メッセージ 

LONG IParamL // 第 1 メッセージパラメータ 

LONG lParam 2 // 第 2 メッセージパラメータ 

)； 

パフメータ • hwndCPl コントロールアプリケーションのメインウィンドウの識別子。 

• uMsg コント ロール パネルアプリケーションに 送られる メッセージを 指定す 

る。 

• IParaml メッセージ により輿なる追加情報を指定する。 

• IParaml メッセージ により異なる追加怙報を指定する。 


民り値 戻り値はメッセージにより異なる。詳細については、個々のコントロールパネルメッ 

セージの説明を照会すること。 


解説 CPIApplet 関数は、コントロールパネルアプリケーションのエントリポイントとして 

供給されるライブラリ定義のコールバック関数である。 

hwndCPl パラメータは 、親ウィンドウのハンドルが必要なダイアログボックスまたは 
ウィンドウに対して使用する。 
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File Instration Utility 



GetRleVersionlnfo 


ン情報取得 


version.dll 



NT 


V c 


BOOL GetFileVersionInfo ( 

LPTSTR IptstrFilename ，// ファイル名のバッファへのポインタ 

DWORD dwHandle ， //無視される 

DWORD dwLen , // ノヽ•ッファのサイズ 

LPVOID IpData //ファイルバージョン M 報を受け取るバッファ 

のポインタ 


V B 


パラメ ータ 


解脱 


戻り僱 

正常終了 


異常終了 


Declare Function GetFileVersionlnfo Lib " version . dll ” Alias " GetFileVersionlnfoA ” 
(ByVal lptstrFilename As String，ByVal dwHandle As Long , ByVal dwLen As Long ， 
IpData As Any ) As Long 

• lptstrFilename 対象ファイル名を指定した NULL で終わる文ネ列のボインタ。 

• dwHandle このノ《ラメータは、無祝される 0 

• dwUn / pDam により指定されるバッファのサイズをバイト単位で指定す 

る。 GetFileVersionlnfoSize 関数は、ファイルバージョン情報の 
バイト単位のサイズを決定する。か / k 如により指定されるバッフ 
了 が十分な大きさでないときは、ファイルバージョン怡報はバッ 
ファのサイズに合わせて短くなる。 

• IpData ファイルバージョン情報を受け取るバッファのポインタ。この値 

は、後で VerQueryVakie 閲数を呼び出すときに使うことができ 
る。ファイルバージョン价報は、16ビット （ Unicode ) フオーマツ 
卜である。 


正常終了 TRUE 

異常終了 FALSE 

詳細なエラー情報は、 GetUstError 関数により取得 0 

GetFileVersionlnfo 関数は、指定されたファイルに関するバージョン怡報を返す。 
他のファイルインストール関数同様、 GetFileVersionlnfo は Win 32 ファイル形式での 
み勋作するが、16ビット Windows ファイル形式では動作しない。 


IpData 


GetFileVersionInfoSize，—VerQuery Value ，— VS _ VERSION_INFO 
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2.4 シェル 


GetFileVersionlnfoSize 

version.dll 

95 

NT 

バージョン情報サイズ取得 





v c DWORD GetFileVersionInfoSize ( 

LPTSTR IptstrFilename ， // ファイル名のバッファへのポインタ 

LPDWORD IpdwHandle // 0が返る変数へのポインタ 

)； 


Declare Function GetFileVersionlnfoSize Lib ’’ version . dll ” Alias ’’GetFileVersion 
InfoSizeA " (ByVal IptstrFilename As String，IpdwHandle As Long ) As Long 


パラメータ 


• IptstrFilename 対象ファイル名が格納されている NULL で終わる文字列のポイ 

夕〇 

• IpdwHandle この関数で0にセットされる変数のポインタ。 


戻り値 

正常終了 


異常終了 


ファイルのバージョン怡報サイズ（バイト単位) 
0 

詳細なエラー怡報は、 GetLastError 関数により取得。 


解説 GetFileVersionlnfoSize 閲数は、オペレーティングシステムが指定されたファイルのバ 

ージョン情報を取得できるかどうかを判定する。バージョン愔報が利用できるとき、 
GetFileVersionlnfoSize は怡報のサイズをバイト単位で返す。他のファイルインストー 
ル関数同様、 GetFileVersionlnfoSize は Win 32 ファイル形式でのみ動作するが、16ビ 
ット Windows ファイル形式では動作しない。 

GetFileVersionlnfoSize 関数は、 GetFileVersionlnfo 関数呼び出す前に呼び出さなけれ 
ばならない。 

参 照 — GetFileVersionlnfo，—VerOuery Value 
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VerFindFile 


インストール 位置判定 



DWORD VerFindFile ( 


DWORD 

LPTSTR 

LPTSTR 

LPTSTR 

LPTSTR 

PUINT 

LPTSTR 

PUINT 


dwFlags ， // I 対数の®;作を条件付けるビットフラグ 

szFileName ， 11イ ンストールするフアイル名 
szWinDir , // Windows ディレクトリ名 

szAppDir ， //インストールするフアイルを指すディレクトリ名 

szCurDir , //インストールするフアイルのカレントデイレク 

トリ名を受け取る 

IpuCurDirLen , //カレントデイレクトリのサイズ 

szDestDir , //インストール先のデイレクトリのパス名を受け 

取る 

IpuDestDirLen H szDestDir ( D 兮べズ 


パラメータ 


Declare Function VerFindFile Lib " version . dll " Alias " VerFindFileA " (ByVal uFlags As 
Long，ByVal szFileName As String , ByVal szWinDir As String , ByVal szAppDir As 
String，ByVal szCurDir As String , lpuCurDirLen As Long , ByVal szDestDir As String ， 
lpuDestDi 

- dwFlags フラグのビットマスク。このパラメータの値には、以下の侦がある。 


フラグ 

VFFF ISSHAREDFILE 


szFileName 


szWinDir 


• szAppDir 


szCurDir 


説明 _ 

ソースファイルは、掬数のアプリケーションにより共有される 
吋能性がある。アプリケーションは、コピーされるファイルの 
坳所を決定するためこの怡報を使う。そのほかの W はすべて将 
来の使用のために予約されている。 


インストールするファイル名へのボインタ。このファイル名はファ 
イル名と拡張子だけを含み、パスは含まない。 

Windows が実行している、または実行されるディレクトリ名のボイ 
ンタ。この文字列は、 GetWindowsDirectory 関数により返される。 
インストールプログラムが一連のファイルをインストールするディ 
レクトリ名へのボインタ。インストールプログラムがアブリケーシ 
ョンをインストールする埸合、このディレクトリがアプリケーショ 
ンの常馬 t ディレクトリになる。アプリケーションの作業ディレクト 
リも、ほかに指定をしない限りこのディレクトリになる。 

インストール済みのファイル（現バージョン）へのパスが格納 
されるハ•ッファのポインタ。ファイルがインストールされていない 
埸合、バッファの長さが0となる0要求がなくても、バッファの長 
さは MAX PATH バイト以上でなければならない《 
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2.4 シェル 


戻り値 


• IpuCurDirLen szCurDir(D ク 《ッファの M さを指定する値へのポインタ 0 このポイ 

ンタは NULL ではならない。関数が制御を戻すとき、 
IpuCurDirLen には、 szCurDir に返さ れた終端の NULL を含むキヤ 
ラクタ単位のノ 、。ス データのサイズが格納される。バッファが小さ 
すぎてすべてのデータが格納できな I 、坳合でも、 IpuCurDirLen の 
値はパスを含んだノ、•ッファのサイズとなる。 

• szDestDir VerFindFile 関数が W 適であると判断したインストール埸所のパス 

が格納されるバッファのボインタ。このパスは0で終わる文字列 
である。ハへソファの及さは、少なくとも _ MAX_PATH バイトで 
なければならない。 

• IpuDestDi rLen szDestDir のパ'、 j フ ァの長さの値のボインタ。このポインタは、 

NULL ではならない。関数が制御を)^すとき、 !puDextDirLen に 
は、 szD 如 £)/> に返された終端の NULL 文字を穴むノスデータのキ 
ヤラクタサイズが格納される。バッファが小さすぎてすべてのデ 
ータが格納できな t 、場合、 IpuDestDirLen の M はパスを入れると 
必要なバッファのサイズとなる。 

ファイルの状態を示すビットマスクを、以下の f め:のいずれかを1つ以 h 返す。 

« 总味 

VFF.CURNEDEST 1*4 適であると判断したインストール先に、インストールされ 

たカレントバージ ョ ンのファイルがない。 

VFF.FILEINUSE インストール された カレントバージョンのファイルを 

Windows が使用中である。このため、ファイルに上逬きした 
り、削除したりすることができない。 

VFF_BUFFTOOSMALL サイズが小さすぎるため対応する文字列を格納できないバッ 

ファが、少なくとも1つある。アプリケーションは、出カバ 
ッファをチヱックし、サイズの足りないバッファを判定しな 
ければならない。 

ほかの flft はすべて将来の使用のために予約されている。 
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解説 VerFindFile 関数は、ファイルをインストールするときに、システム内にあるそのファ 

イルの別バージョンの有無に基づいて、インストールする位 K を判定する 。 Ver 
FindFile 関数の戻り値は、後で VerlnstallFile 関数呼び出しの中で使われる。 

他のファイルインストール関数同様、 VerFindFile は Win 32 ファイル形式でのみ勋作 
するが、16ビット Windows ファイル形式では動作しない。 

VerFindFile 関数は、 OpenFile 関数を使用して、指定されたファイルの抅製を検索す 
る。また、指定された Windows ディレクトリからシステムディレクトリを判定する 
か、そのパスを探索する0 

ファイルがこのアプリケーションに対してプライペートであること ( VFFF_ISSHARED 
FILE ではないこと）を dwflags パラメータが示す坳合、 VerFindFile _数はアプリヶー 
ションのディレクトリがインストールに最適なディレクトリであると判断する。そう 
でない埸合、システムが共有の Windows を実行しているときは、 Windows ディレク 
トリが最適なインストールディレクトリであると判断する。システムがプライベート 
の Windows を実行しているときには、 SYSTEM ディレクトリが iii 適であると判断す 
る。 


参 照 — Get WindowsDirectory ， OpenFile ,— 

.VerlnstallFile 



VerlnstallFile 

version.dll 

95 

NT 

ファイルインストール 


V C 


V B 


DWORD VerInstallFile ( 


DWORD 

LPTSTR 

LPTSTR 

LPTSTR 

LPTSTR 

LPTSTR 

LPTSTR 

PUINT 

)； 


“ Flags ， // 関数の実行状態フラグ 

szSrcFileName , //インストール元ファイル名 
szDestFileName ， 11イ ンストール先ファイル名 


szSrcDir , 

szDestDir , 

szCurDir ， 

szTmpFile ， 

IpuTmpFileLen 


//インストール元ディレクトリ名 
//インストール先ディレクトリ名 
//インストールされるカレントデイレクトリ名 
//インストール中使用される一時ファイル名 
llszTmpHle パラメ ータの文字列サイズ 


Declare Function VerlnstallFile Lib f , version . dir , Alias M VerlnstallFileA " (ByVal uFlags 
As Long , ByVal szSrcFileName As String , ByVal szDestFileName As String , ByVal 
szSrcDir As String , ByVal szDestDir As String , ByVal szCurDir As String，ByVal 
szTmpFile As String , IpuTmpFileLen As Long ) As Long 
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2.4 シェル 


パラメータ 


• uFlags フラグのビットマスク。このパラメータ{似下の値の1つである。 


フラグ 

説明 

VIFF^FORCEINSTALL 

バージョン番号が不適切な場合にもファイルをインストールす 
る0関数は、インストールの問、物理的なエラーだけをチェッ 
クする。 

VIFF.DONTDELETEOLD 

以前にインストールされたファイルがインストール先のディレ 
クトリにないときは、インストール済みのファイルを削除せず 
にファイルをインストールする。 


• szSrcFileName 

• szDestFileName 

• szSrcDir 

• szDestDir 

• szCurDir 

• szTmpFile 

• IpuTmpFileLen 


ほかの値はすべて将来の使用のために予約されている。 
インストールするファイル名へのポインタ。このファイル名 
は、 • srfrc . D / r が指すディレクトリにあるファイル名で、ベー 
スファイル名と拡張子だけを指定し、パスを含めない。 
VerlnstaHFile 関数がインストール時に新しいファイルに指定 
するファイル名へのポインタ。このファイル名は、 
szSrcFilemme(D デ ィレクトリ内のファイル名と輿なることも 
ある。新しいファイル名にはベースファイル名と拡張子だけ 
を指定し、パスを含めない。 

新しいファイルのあるディレクトリ名を格納するバッファへ 
のボインタ。 

新しいファイルがインストールされるディレクトリ名を格納 
するバッファへのボインタ。 VerFindFile 関数の打の/>パ 
ラメータに、この値が返される。 

既存のファイル(現バージョン）があるディレクトリ名を格納 
するバッファへのポインタ〇 VerFindFile 関数の^ CWD/V •パラ 
メータに、この値が返される。 

VerlnstallFilelW 数の M 初の呼び出しで空にするバッファへの 
ポインタ。関数は、インストール元のファイルの一時的な掏 
製ファイル名をこのバッファに格納する。バッファの長さ 
は、少なくとも _ MAX_PATH バイト以上でなければならない。 
及パラメータのバッファの長さの値へのポインタ。こ 
のパラメータは、 NULL であってはならない。関数が制御を 
戻すとき、 IpuTmpFileLen には、 szTmpFile に返されたファイ 
ル名データの終端の NULL 文字を含むバイト単位のサイズが 
格納される。バッファが小さすぎてすべてのデータが格納で 
きな t ゝ埸合、 ^mTmpFileLen の値はそのデータ を格納した埸 
合のサイズが設定される。 
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戻り値 戻り偵は、例外を示すビットマスクである。以下の値のいずれかを丨つ以上を返す。 


m 

怠味 

VIF 一 TEMPFILE 

新しいファイルの一時的な抅製ファイルがインストール先 
のディレクトリにむ:在する。失敗の原 W はほかのフラグに 
も反映される。 

VIF_MISMATCH 

新しいファイルと既存のファイルの wn が丨つ以 1 •.輿なる。 
このエラーは、 VIFF_FORCEINSTALL フラグをセットして 
再度 VerlnstallFile 閲数を呼び出すことにより、無効にでき 
る。 

V1F 一 SRCOLD 

インストールするファイルが既存のファイルよりも古い。こ 
のエラーは、 V1FF_F0RCEINSTALL フラグをセットして付 
度 VerlnstaHFileliy 数を呼び出すことにより、無効にでき 
る。 

新しいファイルと既存のファイルの言語またはコードペー 
ジ fc* (が與なる。このエラーは、 VIFF_F0RCE1NSTALL フラ 
グをセットして洱度 VerlnstallFile 閲数を呼び出すことによ 
り、無効にできる。 

VIF 一 DIFFLANG 

VIF.DIFFCODEPG 

Sift 突む中の Windows のバージョンが衣示できないコード 
ページを、新しいファイルが®求している。このエラーは、 
VIFF.FORCEINSTALL フラグをセットして随 Verlnstall 
File 開数を呼び出すことにより、無効にできる。 

VIF_DIFFTYPE 

新しいファイルが、 1* 存のファイルとは W なるタイプ、サ 
ブタイプ、またはオペレーティングシステムを持つ。この 
エラーは、 V1FF_F0RCEINSTALL フラグをセットして洱度 
VerlnstallFile 問数を呼び出すことにより、無効にできる。 

VIF_WRITEPROT 

既存のファイルが, 1 f き込み禁±である。このエラーは 
VIFF.FORCEINSTALL フラグをセットして再度 
VerlnstallFile 開数を呼び出すことにより、無効にできる。 

VIF.FILEINUSE 

Windows が既存のファイルを現在使用しているため削除で 
きない0 

VIF.OUTOFSPACE 

インストール先のドライブのディスク容 W が足りないため、 
閲数が一時ファイルを作成できない。 

VIF.ACCESSVIOLATION 

アクセス迫反により、ファイルの,说み込み、作成、削除、 
または名前の変史に失敗した。 

VIF_SHARINGVIOLATION 

共釘迫反により、ファイルの説み込み、作成、削除、また 
は名前の変史に失敗した 

VIF 一 CANNOTCREATE 

関数が一時ファイルを作成できない。具体的なエラーはほ 
かのフラグにより示される。 

VIF 一 CANNOTDELETE 

インストール先のファイルや、ほかのデイレクトリにある JW 
バージョンのファイルを関数が削除できない0 
VIF_TEMPFILE ビットがセットされている場合、インスト 
ール作業は失敗し、インストール先のファイルを削除でき 
ないことがある。 
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VIF 一 CANNOTDEUBTECUR 

VIF.CANNOTRENAME 

VIF_OUTOFMEMORY 

VIF.CANNOTREADSRC 
VIF 一 CANNOTREADDST 
VIF.BUFFTOOSMALL 


既 // •バージョンのファイルが削除されていない0 
VIFF_DONTDELETEOLD が指定されて I 、ない。 

閲数は一時ファイルの名前を変史できなかったにもかかわ 
らず、インストール先のファイルをすでに削除した0 

メモリ不足のため、問数が嬰求された操作を完了できない。 
通常は、アプリケーションが镅ファイルを賊開しようと 
してメモリを使い切ったことを立味する。 

間数がインストール元のファイルを说み取れない。これは、 
不適切なノヽ°スが指定されたということを总味•する。 

ra 数がインストール先の(既むの)ファイルを説み取れない。 
このため、阅数はファイルの诚性を, sw ベる ことができない。 

szTmpFile バッファが小さすぎるため、一時ファイルの前 
を格納できない。関数が制御を保すとき、 IpuTmpFikLen に 
は、ファイル名の保持に必费なバッファのサイズが格納さ 
れる。 


ほかの侦はすべて将来の使用のために予約されている。 

解説 VerInstallFile _ 数は、 VerFindFilel 対数から返された怡報に基づいて、ファイルのイ 

ンストールを試みる。 

VerlnstallFile 関数は圧縮ファイルを展開し、ユニークなファイル名を割り付け、日付 
の古いファイルなどのエラーをチヱックする。 

他のファイルインストール関数同様、 VerlnstaHFile は Win 32 ファイル形式でのみ勋作 
するが、16ビット Windows ファイル形式では動作しない。 

VerlnstallFile 関数は、ファイルをインストールディレクトリからインストール先のデ 
ィレクトリにコピーする。私に指定した以前バージョンのファイルが存在する 
場合、 VerInstallFilel « 数はファイルのバージョン怙報を比較する 0 既存のファイルの 
バージョンがインストールしようとしているファイルのバージョンよりも新しいとき、 
またはファイルの诚性が全く異なるときには(たとえば、ファイルの言語属性が輿な 
るとき）、丨つ以上のエラー値を返す。 

VerlnstallFile 関数は、一時ファイルをインストール先のディレクトリに残す。アプリ 
ケーションは、エラーを修復するか、一時ファイルを削除することができる。エラー 
を修復する埸合、 VerlnstallFile 閲数は、既存のファイルを削除して、一時ファイル 
の名前をオリジナルファイル名に変更する。 

参 照 —VerFindFile 
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VerLanquageName 

言語識別子変換 


kernel32.dll 


95 


NT 


V C 

V B 

パラメータ 


戻り値 


DWORD VerLanguageName ( 

DWORD wLcmg , //Microsoft 言語識別子 

LPTSTR szLang ， // 言語文字列のバッファへのポインタ 

DWORD nSize //バッファのサイズ 

)； 

Declare Function VerLanguageName Lib " kemel 32" Alias " VerLanguageNameA '' 
(ByVal wLang As Long，ByVal szLang As String , ByVal nSize As Long ) As Long 

• wLang バイナリ形式の Microsoft 百語識別/を衍定する 0 たとえば 、 Ver 

LanguageName は 0 x 040 A をカスチリァ系スペイン語に変換する 0 
VerLanguageName が識別子を認識できな t 、埸合、ぎパラメー 
夕にはデフ オル 卜の文字列 (“ Language - Neutral ”) を指すボインタが 
格納される。 Win 32 がサボートする言語識別子について詳しくは、 
「解説」を参照。 

• szLang 客 パラメータで 指定された言語を表す NULL で 終わる义す-列 

ノくツファのホ°インタ。 

• nSize 尺が指すバッファのサイズをバイト単位で指定する。 

正常終了 1バッファに格納された文字列のバイト単位のサイズ。この値には文 

字列の終端の NULL 文字は含まれない。この値がバッファサイズよ 
りも大き t 、埸合は、文字列の長さがバッファサイズに切り詰められ 
る。 

輿常終了 不明な言語識別子 (=0) は、エラーにならない。 
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2.4 シェル 


解脱 


VerLanguageName _ 数は、バイナリ表現の Microsoft 言 m 識別/を、〇始を表すテキ 
ストに変換する。 

通常インストールプログラムは、 Vei ^ u e ryValiie _ 数が返す言語識別子を変換すると 
きにこの I 対数を使う。変換されたテキスト文字列は、言語の競合が発生した場合に、 
処理を続行する方法をユーザーにたずねるダイアログボックスの中で使われることが 
ある。 


以ドは、使用できる言語識別子とその言語である。 


識別子 

言語 

識別子 

nm 

0 x 0000 

Language-Neutral (言語不明 > 

0 xO 40 E 

ハンガリー語 

0 x 0400 

デフォルト言語 

0 x 040 F 

アイスランド骀 

0 x 0401 

アラビア語 

0 x 0410 

ィタリァ語 

0 x 0402 

ブルガリア語 

0 x 0810 

スイス系イタリア語 

0 x 0403 

カタロニア語 

0 x 0411 

日本語 

0 x 0404 

伝統的な中国語 

0 x 0412 

韓国語 

0 x 0804 

簡体字中国語 

0 x 0413 

オランダ語 

0 x 0405 

チェコ語 

0 x 0813 

ベルギー系オランダ誚 

0 x 0406 

デンマーク語 

0 x 0414 

ノルウェー語-ブークモール 

0 x 0407 

ドィツ語 

0 x 0814 

ノルウェー語•ニーノシク 

0 x 0807 

スイス系ドイツ語 

0 x 0415 

ポーランドが 

0 x 0408 

ギリシャ語 

0 x 0416 

ブラジル系ポルトガル鸪 

0 x 0409 

アメリカ英語 

0 x 0816 

ポルトガル語 

0 x 0809 

イギリス英語 

0 x 0417 

レートロマンス語 

0 x 0 C 09 

オーストラリア英語 

0 x 0418 

ルーマニア語 

0 x 1009 

カナダ英語 

0 x 0419 

ロシア語 

0 x 040 A 

カスチリア系スペイン語 

0 x 041 A 

クロアチア-セルビア鸪（ラテン） 

0 x 080 A 

メキシコ系スペイン語 

0 x 081 A 

セルビア-クロアチア語(キリル） 

OxOCOA 

現代 スペイン語 

0 x 041 B 

スロバキア語 

0 x 040 B 

フィンランド語 

0 x 041 C 

アルバニア語 

0 x 040 C 

フランス語 

0 x 04 ID 

スウヱーデン語 

0 x 080 C 

ベルギー系フランス語 

0 x 04 IE 

タイ語 

OxOCOC 

カナダ系フランス語 

0 x 04 IF 

トルコ語 

OxlOOC 

スイス系フランス語 

0 x 0420 

ゥルドゥー語 

0 x 040 D 

へブライ語 

0 x 0421 

パハサ語 



参 照 


— VerOueryValue 
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Value 

version.dll 

95 

NT 


ンリソース 内容取得 


V C 


V B 


パラメータ 


BOOL VerQueryValue ( 

CONST LPVOID pBlock , // バージョンリソースのバッファへのポインタ 
LPTSTR IpSubBlock , //取得する値へのポインタ 

LPVOID * IplpBuffer ， //バージョンポインタのバッファへのポインタ 

PUINT puLen //バージョン値の長さを / J 々すバッファへのポイ 


Declare Function VerQueryValue Lib " vcrsion . dll M Alias " VeiQueryValue " (pBlock As 
Any , ByVal IpSubBlock As String，ByVal IpIpBuffer As Long，puLen As Long ) As 
Long 

• pBlock GetFileVersionlnfo が返すバージョン倩報リソースを格納するバッ 

フ ア へのポインタ。 

• IpSubBlock 取得するバージョン怡報の値を指定する、0で終わる文字列へのポ 

インタ。文字列には円記号⑺で区切られた名前と、以下の形式の 
いずれかを指定できる。 

説明 

ルートブロックを指定する。問数は、バージョン怡 
報リソース用の VS _ F 1 XEDRLEINF 0 構造体へのポ 
インタを取得する。 

変数怙報ブロック内の変換テーブルを指定する。阒 
数は、莒骀識別子および文字セット識別子の配列 
を指すポインタを取得する。アプリケーションはこ 
れらの满別子を使用して、バージョン怡報リソース 
の中に言語固有ブロックの名前を作成する。 

ti ブロック内の tft を衍定する。 lang-charset 
の名前は、リソースの変換テーブルにある言語およ 
び文字セットの識別子のペアである。 lang - charset の 
名前は16進の文字列で衍定しなければならない。 
string - name の名前は、後述の「解说」で説明する 
定義済み文字列の中のいずれかになる。 

• IpIpBuffer バージョン情報値のポインタを取得するノ、•ッファへのポインタ。 

• puLen バージョン情報値のバイト単位の長さを取得するバッファへのボイ 

ンタ〇 



民り値 バージョン愔報が利用可能な埸合 0以外 

指定された名前が存在しない、または 0 
IpvBlock が指すリソースが無効の場合 
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解説 VerQuery Value 関数は、指定されたバージョン怡報リソースから、遴択されたバージ 

ョン怙報を返す。適切なリソースを得るには、 VerQueryValue を呼び出す前に 
GetFileVersionlnfo を呼び出さなければならない。他のファイルインストール関数同 
様、 VerQueryValue は Win 32 ファイル形式でのみ勋作するが、16ビット Windows フ 
ァイル形式では®;作しない。 

Win 32 API では、以 f のバージョン怙報定義済み文字列を含む。 


ComDanvName 、 FileDescription、File Version 、 IntemalName 、 
LegalCopy right 、 OriginalFiIename , ProductName、Product Version 


以下は、バージョン怡報のブロックよりファイル定義の文字列値の取得方法である。 
VerQueryValue<pB 丄 ock, 

TEXT(''WStringFilelnfoWO 40904 E4WFileDescription /, ), 

&lpBuffer, 

ScdwBvtes); 


VerQueryValue I 对数を呼び出す前に GetFileVersionlnfoSize や GetFileVersionlnfo |划数 
により、 pBlock バッファを初期化する必 要がある。 

参 照 — GetFileVersionlnfo ，— GetFileVersionInfoSize，—VS 一 FIXEDF 1 LEINFO , 

— VS VERSION INFO 


| Screen Saver 

3 



■■1 


Def Scree n Save r P roc 


95 

NT 

スクリーンセーバーメッセージ 処理 


V C 


パラメータ 


LONG DefScreenSaverPrcx :( 
HWND hWnd , 
UINT msg t 
WPARAM wParam ， 
LPARAM IParam 
)； 


// スクリーンセーバーウインドウのハンドル 
//メッセージ 

//第1メッセージパラメータ 
//第2 メッセージパラメータ 


• hWnd スクリーンセーノ《ーウィンドウの識別子*。 

• msg 処理するメッセージを指定する。 DefScreenSaverProc 関数が応答する 

メッセージのうち、スクリーンセーバーの動作に関するものを「解 
説」に示す。これらのメッセージに対してスクリーンセーバーアプリ 
ケーションが異なる動作を実行しなければならない埸合は、アプリ 
ケーシヨンの ScreenSaverProc ウインドウプロシージャがそのメッセ 
ージを処理する。 
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• wParam メ ッ セージに 依存する追加•報を指定する 0 

• IParam メッセージに依存する追加情報を指定する。 

戻り値 戻り値はメッセージ処理の結果を示しており、送られたメッセージにより異なる。 


解脱 


参 照 


DefScreenSaverProclJy 数は、 スクリーンセーバーアプリケーションが 処理 しないメッ 
セージのデフオルトの 処理を行う。 

スクリーンセーバーアプリケーションの ScreenSaverProc ウインドウプロシージャは、 
DefWindowProclJy 数の代わりに DefScreenSaverProcI 対数を使わなければならない 0 
DefScreenSaverProcI 対数は、 スクリーンセーバーの 動作に影背を与えないメッ セージ 
をす ベて DefWindowProc に渡す。 

以ドのテーブルにウィンドウメッセージ別の DefScreenSaverProc の処理を示す 0 


メッセーシ 

WM _ ACTIVATE . WM_ACTIVATEAPP 

WM_NCACTIVATE 

WM _ SETCURSOR , WM_RBUTTON 

WM.DESTROY 
WM SYSCOMMAND 


応答 

が FALSE であれば、スクリーンセーバ 
一をクローズする。 

wParam の侦が FALSE のときは、スクリーンセ 
ーバーが人カフォーカスを火おうとしているこ 
とを示す。スクリーンセーバーは、 WM_CLOSE 
メッセージを送ることによりクローズする。 

カーソルを NULL に,设定して、阀面からカーソ 
ルを削除する。 DOWN , WM_MBUTTON 
DOWN ， WM _ PostQuitMessagl»l 数を呼び、スク 
リーンセーバーをクローズする。 

WM _ CLOSE メッセージにより、スクリーンセー 
バー ウィン ドウをクローズする。 

WM.SYSCOMMAND メッセージの パ 

ラ メータが SC_CLOSE か SC—SCREENSAVE な 
らば、 FALSE を返す。 


DefWindowProc ， PostQuitMessage ，— ScreenSaverProc ，— WM_ACTIV ATE ， 

— WM _ ACT 1 V ATEAPP ，— WM - CLOSE ，— WM . DESTROY ,— WM . KEYDOWN , 
— WM _ KEYUP ,— WM _ LBUTTONDOWN ，— WM _ MBUTTONDOWN , 

― WM _ MOUSEMOVE ,— WM_NC ACTIVATE ，— WM . RBUTTONDOWN , 

—WM SETCURSOR ，— WM 一 SYSCOMMAND 
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RegisterDialogClasses 


95 

NT 

ウィンドウクラス登録 


BOOL RegisterDialogClasses ( 

HANDLE hlnst // アプリケーションインスタンスのハンドル 



)； 


パラメータ 

• hlnst ••ウ 1 

f ンドウクラスを登録するモジュールのインスタンスの識別子。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怡報につ V 、ては、 GetLastError 関数で取得 0 

解説 RegisterDialogClasses 閲数は、スクリーンセーバーの設定のダイアログボックスで 

必要な、標準以外のウィンドウクラスを登録する。 

RegisterDialogClasses 関数はエクスポートしてはならない 0 この関数は、 
"SCRNS A VE . LIB " ファイルで定義されているルーチンから呼び出される。 

スクリーンセーバーが設定用のダイアログボックスに対して特別なウィンドウクラス 
を登録しないとき、 RegisterDialogClasses 関数は TRUE を返す。 

参 照 —► ScreenSaverConfigureDialog 
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ScreenSaverConfiqureDialoq 


95 

NT 

スクリーンセーバー設定ダイアログメ ッ セージ受け取り 


V C 


パラメータ 


BOOL ScreenSaverConfigureDialog ( 


HWND hDIg , 

UINT message , 

WPARAM wParam , 
LPARAM IParam 


//ダイアログボックスのハンドル 
//メッセージ 

//第1メッセージパラメータ 
//第2 メッセージパラメータ 


)； 


• hDlg 設定用のダイアログボックスの識別子。 

• message メ ッ セージ を指定する。 

• wParam メッセージに 依存する追加 M 報を指定する。 

• IParant メ ッ セージに 依存する追加情報を指定する。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


ScreenSaverConfigureDialogliy 数は、 WM_INITDIALOG メッセージに応答する場合、 
SetFocus 関数を呼び出してダイアログボックスのコントロー ルの I ゝずれかに入カフォ 
ーヵスを設定するならば FALSE を返す。それ以外の埸合は TRUE を返し、フォーヵ 
スが与えられるダイアログボックスの M 初のコントロールに キー ボードフォーカスが 
設定される。 


解説 ScreenSaverConfigureDialog 関数は、スクリーンセーバーの設定用のダイアログボッ 

クスに送られたメッセージを受け取る。 ューザー による設定をサボートするスクリー 
ンセーバーは、この関数を利用しなければならない。 

設定用のダイアログボックスのダイアログボックステンプレートには、 
DLG _ SCRNSAVECONFlGURE 識別子を指定しなければならない。 

ダイアログボックスプロシージャは、ダイアログボックスにデフオルトのウィンドウ 
クラス ( WC _ DIALOG ) が使われて t ゝる埸合にのみ使われる。ダイアログボックステン 
プレートでクラスが明示的に指定されていない場合アプリケーションは、デフォルト 
のクラスを使う。ダイアログボックスプロシージャはウィンドウプロシージャに似て 
いるが、不敗なメッセージを処理するために DefWindowProc 関数を呼び出してはな 
らない0不费なメッセージは、デフォルトのダイアログボックスプロシージャが内部 
的に処理する。 

ScreenSaverConfigureDialog 関数は、アプリケーションのモジュール定義フアイル 
(• DEF ) の EXPORTS でエクスポートしなければならない。 

梦 か DefWindowProc , RegisterDialogClasses,SetFocus 
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2.4 シェル 


ScreenSaverProc 


95 

NT 

スクリ ーンセーバーメッセージ 処理 


V C 


パラメータ 


戻り値 


解説 


参 照 


LONG ScreenSaverProc ( 

HWND hWnd, // スクリーンセーバーウインドウのハンドル 

UINT message, 1/メ ッセージ 

WPARAM // 第 1 メッセージパラメータ 

LPARAM IParam // 第 2 メッセージパラメータ 

)； 

• hWnd ウィンドウの識別子。 

• message メッセージを指定する。 

• wParam メッセージに依存する追加情報を指定する。 

• IParam メッセージに依存する追加愔報を指定する。 

メッセージ処理の結果を返す。値は、処理されたメッセージにより異なる。 

ScreenSaverProclW 数は、スクリーンセーバーウインドウに送られたメッセージを受 
け取る。 

スクリーンセーバーの ScreenSaverProc ウインドウプロシージャは 、 DefWindowProc 
関数の代わりに DefScreenSaverProcI 対数を使用してデフオルトのメッセージを処 f ?6 し 
なければならない。 DefScreenSaverProc 関数は、スクリーンセーバーの動作に影膊を 
与えないメッセージを DefWindowProc 関数に渡す。 

ScreenSaverProc 関数は、アプリケーシヨンのモジュール定義フアイル （. DEF ) の 
EXPORTS でエクスポートしなければならない。 


— DefScreenSaverProc,DefWindowProc 
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[" Shell Libraty 

画 

DraqAcceptFiles 

shell 32 .dll 

95 

NT 

ドロップファイル受け入れ登録 


V C 


V B 


パラメータ 


解脱 


参 照 


void DragAcceptnles ( 

HWND h \ Vnd y // 登録するウィンドウのハンドル 

BOOL /Accept //承諾オプション 

)； 

Declare Sub DragAcceptFiles Lib " shell 32. dll ” Alias " DragAcceptFiles " (ByVal hwnd 
As Long , ByVal fAccept As Long ) 

• hWnd ドロップされたファイルを受け入れるかどうかを登録するウィンドウ 

の識別子。 

• /Accept AVVm / パラメータで指定されたウィンドウがドロップされたファイルを 

受け入れるかどうかを指定する。ドロップされたファイルを受け入れ I 
るときはこの値に TRUE を、ファイルを受け入れないようにするとき 
は FALSE を指定する。 

DragAcceptFiles 関数は、指定されたウィンドウがドロップされたファイルを受け入 
れるかどうかを登録する。 

アプリケーションが // kre〆 パラメータに TRUE を設定して DragAcceptFiles 閲数を呼 
び出した埸合、ファイルマネージャから送られる WM_DROPFILES メッセージにより 
処理を識別する。 

—WM DROPFILES 


DraaFinish 

shell 32 .dll 

95 

NT 

ドロップファイルメモリ解放 


mm ^ void DragFinish ( 

HDROP hDrop // 解放するメモリのハンドル 

)； 

V B Declare Sub DragFinish Lib " shell 32. dll " Alias ’ ’ DragFinish ” (ByVal hDrop As Long ) 

パラメータ • hDrop ドロップされたファイルを記述する構造体の識別子。このハンドルは、 

WM_DROPFILES メッセージの wParam パラメータでアプリケーション 
に渡される。 
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2.4 シェル 


解説 


参 照 


DragFinish 関数は、 Windows がフアイル名をアプリケーションに fc 送するために割り 
当てたメモリを解放する。 

—WM DROPFILES 


DraaQueryFile 

shell 32 .dll 

95 

NT 

ドロップファイル名取得 


V C 


V B 


パラメータ 


戻り値 


解 

説 

参 

照 


UINT DragQueryFile ( 

HDROP hDrop ， 
UINT iFile , 

LPTSTR IpszFile ， 
UINT cch 

)； 


// ドロップされたファイルの構造体のハンドル 
//問い合わせるファイルのインデックス 
//返されるファイル名のバッファへのポインタ 
//ファイル名のバッフアのサイズ 


Declare Function DragQueryFile Lib ’_ shell 32. dll ” Alias " DragQueryFileA " (ByVal 
HDROP As Long，ByVal UINT As Long，ByVal IpStr As String , ByVal ch As Long ) 
As Long 

• hDrop ドロップされたファイルのファイル名を含む構造体の識別子。 

• [File 問い合わせるファイルのインデックスを指定する。 iFile パラメータの 

偵が OxFFFFFFFF のときには、 DragQueryFile 関数はドロップされた 
ファイルの個数を返す。 iFile パラメー タの値が0からドロップされた 
ファイルの総数の間のときには、その値に対応するファイル名を 
IpszFile パラメータ が 指す バッファに コピーす る 0 

• IpszFile 閲数は、ドロップされたファイルのファイル名をこのバッファに返す。 

このファイル名は、 NULL で終わる文字列である。このパラメータが 
NULL のとき、 DragQueryFile 関数はファイル名のバッファに必要な 
サイズをバイト単位で返します。 

•cch IpszFile バッフ了のサイ ズをバイト取位で指定する。 

関数がファイル名をバッファにコピーした埸合は、コピーされたバイト数を返す。こ 
のとき終端の NULL は含まない。 

iFile が OxFFFFFFFF の場合は、ドロップされたファイルの個数が返される。 

/ F / fe が0からドロップされたファイルの総数の間で、 / pszFile が NULL の場合は、パ 
ッファに必要なサイズが返される。この時終端の NULL は含まない。 


DragQueryFile 関数は、ドロップされたファイルのファイル名を取得する。 


— DragQueryPoint 
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DragQueryPoint 

shell 32 .dll 

95 

NT 

ファイルドロッブ時のマウス座標取得 


V C 


V B 


パラメータ 


戻り値 


解脱 


参 照 


BOOL DragQueryPoint ( 

HDROP hDrop ， // ドロップされたファイルの構造体のハンドル 

LPPOINT Ippt //マウス座標の構造体へのポインタ 

)； 

Declare Function DragQueryPoint Lib M shell 32. dH " Alias .’ DragQueryPoint ” (ByVal 
HDROP As Long，IpPoint As POINTAFI ) As Long 


• hDrop ドロップされたファイルを記述する構造体の識別子。 

- Ippt 関数がファイルのドロップされたときのマウス位！ S の座標を格納する、 

POINT 構造体へのポインタ。 

ファイルがクライアント領域にドロップされた場合 ] TRUE 
それ以外 FALSE 

DragQuery Point 関数は、 ユーザーが マウスの左ボタンを離したときの カー ソ ル 位置の 
座標を POINT 構造体に格納する。座標が返されるウィンドウは、 WM.DROPFILES 
メッセージを受け取ったウィンドウである。 DragQueryPoint 関数は、ファイルがドロ 
ップされたときのマウスが指す座標を取得する。 

— DragQuery File ，— POINT ，— WM_DROPFILES 
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ExtractAssociatedlcon 

shell 32 .dll 

95 

NT 

アイコンハンドルの取得 


V C 


V B 


パラメータ 


戻り僅 


解脱 


参 照 


HICON ExtractAssociatedIcon ( 
HINSTANCE hlnst , 
LPTSTR IpIconPath ， 

LPWORD Ipilcon 

)； 


//アプリケーション 手続き ハンドル 
//アイコンのパスとフアイル名へのポインタ 
//アイコンのインデックスへのポインタ 


Declare Function ExtractAssociatedlcon Lib " shell 32. dll " Alias " ExtractAssociatelconA '' 
(ByVal hlnst As Long，ByVal lpIconPath As String , Ipilcon As Long ) As Long 

• hlnst アプリケーションがこの閲数を呼ぶ手続きを指定する。 

• lpIconPath 要求されたアイコンの完全なノヽ°ス名とファイル名を指定する文字列 

へのポインタ。関数は指定のファイルから、または指定のファイル 
に関連する実行ファイルより、アイコンハンドルを引き出す。アイ 
コンハンドルが実行ファイルより取得された場合、_数は、 
lpIconPath により指される文字列の中に、実行する完全なパス名と 
ファイル名を格納する。 

• Ipilcon 取得されたアイコンハンドルのインデックスを指定する WORD ボイ 

ンタ。実行ファイルから取得されたアイコンハンドルは、 Iplcon に 
より指された WORD ボインタの中にアイコンの識別子を格納する。 


正常終了 アイコンハンドル 

異常終了 NULL 

アイコンが 閲迚する実行 ファイルより 取得された埸合、関数は、 lpIconPath で指され 
る文字列の中に実行 ファイルの 完全なパス名と ファイル 名を格納する。また、 / pi/con 
により 指される WORD ポインタの 中に アイコンの 識別子を格納する。 

関数が正常に処理されない場合は、 NULL を返す。 

ExtractAssociatedlcon 関数は、 ファイルや |划述す る実行ファイルの中からアイコンを 
検出し そのハンドルを 返す。 

ExtractAssociatedlcon |划数は、 M 初に/ で 指定された アイコンを 探す。関数 
が、 そのファイルよりアイコンハンドルを 取り出せなかった埸合、実行 ファイルの 中 
を 探す。 ファイル 名の拡張子に基づき関連付けされた実行 ファイルは、 ユーザー ご 
とに情報を登録され、 ファイルの 関速付け時の表示機能として利用が可能になって 
いる。 

- ♦Extractlcon 
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Extractlcon 

shell 32 .dll 

95 

NT 



ンハンドル取得 


HICON ExtractIcon ( 

HINSTANCE hlnst ， // インスタンスハンドル 

LPCTST RlpszExeFileNameJI 了 イコンファイル名 

UINT nlconlndex //取得するアイコンのインデックス 

)； 

v B Declare Function Extractlcon Lib " shell 32. dll " Alias " ExtractlconA " (ByVal hlnst As 

Long , ByVal IpszExeFileName As String , ByVal nlconlndex As Long ) As Long 

パラメータ • hlnst 関数を呼び出すアプリケーションのインスタンスの識別子。 

• IpszExeFileName 実行可能ファイル、 DLL 、 またはアイコンファイルを指定す 

る NULL で終わる文字列へのボインタ。 

• nlconlndex 取得するアイコンのインデックスを指定する。この値が0のと 

きは、指定されたファイルの最初のアイコンハンドルを返 
す。この値が-1のときは、指定されたファイルにあるアイコ 
ンの総数を返す。 

戻り値鼸 正常終了 |アイコンハンドル 

実行可能ファイル、 DLL アイコンのいずれでもない場合 1 

ファイルにアイコンが存在しない埸合 NULL 

解説 Extractlconl 対数は、指定された実行可能ファイル、ダイナミックリンクライブラリ 

( DLL )、 またはアイコンファイルから、アイコンのハンドルを取得する。 
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2.4 シェル 


FindExecutable 

shell 32 .dll 

95 

NT 

関連する実行ファイル取得 


v c HINSTANCE FindExecutable ( 

LPCTSTR IpFile , // ファイル名の文字列のアドレス 

LPCTSTR IpDirectory ， //デフォルトディレクトリの文字列へのポインタ 

LPTSTR IpResult //実行口 J 能ファイルが返される文字列へのポインタ 

)； 

v B Declare Function FindExecutable Lib " shell 32. dir , Alias " FindExecutableA " (ByVal 

lpFile As String , ByVal lpDirectory As String , ByVal IpResult As String ) As Long 


パラメータ 


戻り値 


解脱 


参 照 


•lpFile ファイル名を指定する、 NULL で終わる文字列のポインタ。ここに 

は、文咨ファイルか実行可能ファイルを指定できる。 

• lpDirectory デフォルトディレクトリを指定する NULL で終わる文字列へのボイ 

ンタ〇 

• IpResult 実行可能ファイルの名前が返さるバッファへのポインタ。このファ 

イル名は、 NULL で終わる文字列である。この文字列は、[1用く1コ 
マンドが进択されたときに起勋されるファイルを示し、 lpFile パラ 

メータで指定されるファイルを実行する。 

• 

FindExeaitable 関数の戻り値は、問数が失敗したときに冇効である。閲数が正常に終 
了しなかった坳合の戻り做は32以下である。発生する可能性のあるエラー値は、「解 
説」に記述する。 

FindExecutable 関数は、指定されたファイル名に関連付けられて t 、る実行可能ファイ 
ル (. EXE ) の名前やハンドルを取得する0 

FindExecutable 閲数の W り値は、 IpResult パラ メータが DDE の対話を初期化する•松求 
に対しサーバが応答しないとき、開始されている DDE サーバのパス名を設定する。 
指定されたファイルタイプに対する関連付けがな t 、埸合、 FindExecutable 関数は31を 
返す。以下は、そのほかに発生する可能性のあるエラー to 1 (である。 


m 

意味 

0 

システムメモリ、またはリソースが足りない。 

ERROR _ FILE _ NOT_FOUND 

衍定されたファィルが存在しない。 

ERROR _ PATH _ NOT_FOUND 

衍定されたパスが存在しない。 

ERROR _ BAD_FORMAT 

. EXE ファイルの不 lK ( Win 32 の. EXE でない、または 


.EXE 形式 エラー)。 


— Shell 匕 xecute 
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ShellAbout 

shell 32 .dll 

95 

NT 

Windows が提供するバージョ 

1ン情報のダイアログボックスを表示 


V C int ShellAbout ( 

HWND hWnd , // 親ウィンドウハンドル 

LPCTSTR szApp ， //タイトルバーと1行目のテキスト 

LPCTSTR szOtherStuff , //他のダイアログテキスト 

HICON hlcon //表示するアイコン 

)； 

V B Declare Function ShellAbout Lib " shell 32. dll " Alias " ShellAboutA " (ByVal hwnd As 

Long，ByVal szApp As String，ByVal szOtherStuff As String，ByVal hlcon As Long ) 
As Long 

パラメータ • / jVVm / 親 ウィンドウの識別子。このパラメータは、 NULL でもよい。 

• szApp ダイアログボックスのタイトルバーに表示するテキスト 

と ’ MicrosoftWindows ” または” MicrosoftWindovvsNT ’ の次の行に表不 
するテキストへのボインタ。テキストに”#’’が含まれていると2つの部 
分に分れてしまい、タイトルバーに#より左の部分を、 
” MicrosoftWindows ” または ，， MicrosoftWindowsNTT の次の行に# の右 
の部分を表示する。 



• szOtherStuff 

バージョンと著作権表示の下に表示するテキストへのポインタ。 


• hlcon 

関数がダイアログボックスに表示するアイコンの識別子0このパラ 
メータが NULL の埸合、|划数は、 MicrosoftWindows または 
MicrosoftWindowsNT のアイコンを表示する 0 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


解説 ShellAbout 関数は、 Windows が提供するバージョン情報のダイアログボックスを表示 

する。 

Windows が提供するバージョン情報のダイアログボックスとは、[マイコンピュータ】 
の[ヘルプ】-[バージョン情報]で表示されるダイアログボックスである。 
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2.4 シェル 


ShellExecute 

shell 32 .dll 

95 

NT 

指定ファイルのオーブン、表示、実行 

v C HINSTANCE ShellExecute ( 




HWND hwnd y //親ウ 

インドウのハンドル 




LPCTSTR IpOperation ， // 実行する操作の文字列へのポインタ 
LPCTSTR IpFUe, //ファイル名やフォルダ名の文字列へのポインタ 

LPCTSTR IpParameters, //実行可能ファイルのパラメータの文字列へのポイ 

ンタ 


LPCTSTR IpDirectory ， //デフォルトディレクトリの文字列へのポインタ 
INT nShowCmd //オープン時のファイルの表示の有無 



V B 


パラメータ 


Declare Function ShellExcute Lib M shell 32. dH M Alias f , SheIlExcuteA M (ByVal hwnd As 
Long ByVal lpOperation As String，ByVal IpFile As String，ByVal IpParameters As 
String , ByVal IpDirectory As String，ByVal nShowCmd As Long ) As Long 

• hwnd 

親ウィンドウの識別子。このウィンドウは、アプリケーションが 
生成するあらゆるメッセージボックスを受け取る。たとえば、ア 
プリケーションはメッセージボックスに、生成するエラーの報告 
をする。 

• lpOperation 

実行する操作を指定する、 NULL で終わる文字列のポインタ。以 
下が文字列の値である。 

文字列 

意味 

“open” 

閲数が/ pF/ かで指定されたファイルをオープンする。ファイルは、実行可 
能ファイルか文穴ファイルである。 Windows 95 では、ファイルは Windows 
95 フォルダである。 

“print” 

1对数が//?で指定されたファイルを印刷する。ファイルは、文泔ファイ 
ルである。ファイルが実行可能ファイルのときは、 ’’open” が指定されたと 
きと同様、ファイルをオープンする。 

“explore” 

Windows 95 のみ。閲数が/で指定されたフォルダを検索する。 



- IpFile オープンまたは表示するファイルを指定する、 NULL で終わる文 

字列へのポインタ。この関数は、実行可能ファイルまたは文書フ 
ァイルをオープンできる。また、文咨ファイルの印刷もできる。 
Windows 95では、 IpFile はオープン または検索するための 
Windows 95フォルダを指定する NULL で終わる文字列へのポイン 
夕である。 

• IpParameters NULL で終わる文字列へのポインタ。 IpFVe パラメータに実行可能 

ファイルを指定するときは、アプリケーションに渡すパラメータ 
をここに指定する。 IpFile パラ メータに文書ファイルを指定すると 
きは、このパラメータは NULL である。 
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• IpDirectory デフォルトのディレクトリを指定する、 NULL で終わる文字列へ 

のポインタ。 

• nShowCmd に実行可能ファイルを指定した場合は、 nShowCmd I こはオー 

プンするときのアプリケーションの表示方法を指定する。このパ 
ラメータは、以下の値のいずれかである。 


SW 


_总味_ _ _ 

HIDE ウィンドウを非表示にし、ほかのウィンドウをアクテ 

イブ f 匕する。 


SW MAXIMIZE 


指定されたウィンドウを W 人表示にする。 


SW MINIMIZE 


指定されたウィンドウをアイコン化し、システムの夕 
スクリスト内のトッブレベルウインドウをアクテイブ化 


する。 


SW RESTORE 


ウィンドウをアクティブ化し表示する。ウィンドウが 
アイコン化または W 大化されているときには、元のサ 
イズと位 Iff に復元する。アプリケーションは、アイコ 
ン化されたウィンドウを m 元するときこのフラグを衍 
定する。 


SW SHOW 


ウィンドウをアクティブ化し、カレントサイズと位沢 
で表示する。 


SW SHOWDEFAULT 


アプリケーションを開始したブログラムにより 
CreateProcess 閲数を通じて STARTUP 1 NFO 構造体に指 
定された SW __ フラグで衣示状態を股定する。アプリケ 
ーションは、メインウィンドウの初期衣示状態をこの 
フラグに,设定するため Show Window 閲数を呼ぶべきで 
ある。 


SW_SHOWMAXIMIZED ウィンドウをアクティブ化し、 W 人化ウィンドウとし 

てぶ示する。 


SW.SHOWMINIMIZED ウインドウをアクティブ化し、アイコン表示にする。 


SW 一 SHOWMINNOACTIVE 

SW_SHOWNA 

SW SHOWNOACTIVATE 


SW SHOWNORMAL 


ウィンドウをアイコン表示にする。アクティブなウィ 
ンドウは、アクティブな状態のまま。 

ウィンドウをカレントの状態で表示する。アクティブ 
なウィンドウは、アクティブな状態のまま。 

以前に在示されたサイズと位 K でウィンドウを衣示す 
る。アクティブなウィンドウは、アクティブな状態の 
まま〇 

ウィンドウをアクティブ化し表示する。ウィンドウが 
アイコン化または M 人化されているときには、元のサ 
イズと位 K に復元する。アプリケーションは W 初にウ 
ィンドウを表示するとき、このフラグを指定すべきで 
ある。が文, 1 f ファイルを指定するとき 、 nShow 
Om / は0である。 
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2.4 シェル 


戻り値 


関数が正常に終了した埸合は、実行するアプリケーションのインスタンスハンドル、 
またはダイナミックデータエクスチェンジ ( DDE ) サーバアプリケーションのハンドル 
を返す。 

関数が正常に終了しなかった場合は32以下の値を返す。以下は、そのエラー値 / C あ 
る。 


侦 

总味 

0 

オペレーティングシステムのメモリかリソースが足りな 

ERROR _ FILE _ NOT_FOUND 

、 〇 

指定されたファイルが見つからない。 

ERROR 一 P ATH _ NOT_FOU N D 

指定されたパスが兌つからない。 

ERROR _ BAD_FORMAT 

. EXE ファイルの不 iI :( Win 32 以外の. EXE または. EXE 形 


式のエラー)。 

SE . ERR.ACCESSDENIED 

Windows 95のみ。オペレーティングシステムは、指定さ 


れたファイルへのアクセスを拒否した。 

SE _ ERR_ASSOCINCOMPLETE 

ファイル名の閲迚付けが、不十分または不正である。 

SE _ ERR_DDEBUSY 

他の DDE 変換が処理されているため、 DDE 変換が処理 


できない。 

SE _ ERR_DDEFAIL 

DDE 変換が失敗した。 

SE _ ERR_DDETIMEOUT 

DDE 変換が费求時問切れで処理されなかった。 

SE 一 ERR_DLLNOTFOUND 

Windows 95のみ。指定されたダイナミックリンクライブ 


ラリが見つからない。 

SE 一 ERR 一 FNF 

Windows 95のみ。指定されたファイルが見つからない。 

SE _ ERR_NOASSOC 

ファイル名の拡張子として閲迚付けられたアプリケーシ 


ョンがない。 

SE _ ERR_OOM 

Windows 95のみ。処理するために十分なメモリがない。 

SE 一 ERR_PNF 

Windows 95のみ。指定されたノ、。スが見つからない。 

SE _ ERR_SHARE 

共有違反が発生した。 



ShellExecme 閲数は、指定されたファイルをオープン、または表示する。ファイルに 
は、実行可能ファイルか、文赉ファイルが指定できる。 ShellExecineEx 関数も参照す 
ること0 

IpFile パ ラメータで指定するファイルには、文迸ファイルまたは実行可能ファイルを 
指定できる 0 文書ファイルの埸合、 ShellExecutelJy 数は/ 〆 ? per ⑽洲パラメー タの値に 
応じて、ファイルのオープンまたは表示を行う。実行可能ファイルの埸合には、 
IpOperation パラメータに表示が指定されていても、ファイルは表示されずにオーブ 
ンされる。 
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Windows 95の埸合、 ShellExecute を使 I ^Windows 95のフォルダをオーブンやエクス 
ポートすることができる。フォルダのオープンは、以下の様に行う。 

ShellExecute ( handle , NULL , path _ to _ folder , NULL , NULL , SW _ SHOWNORMAL ); 

または 

SheHExecute ( handle ， n open M ，path 一 to _ folder ， NULL ， NULL ， SW _ SHOWNORMAL ); 
フォルダのエクスポートは、以下の様に行なう。 

ShellExecute ( handle ，" explore "， path — to _ folder ， NULL ， NULL , SW _ SHOWNORMAL ); 

IpOperation が NULL のとき、 / pF // e で指定されたファイルを対象とする 0 IpOperation 
が「オープン」または、「エクスポート」のときは、強制処理する。 

参照 -*■ FindExecutable,ShellExecuteEx 
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V C BOOL BitBlt ( 


HDC 

hdcDest ， 

//軺送先のデバイスコンテキストのハンドル 

int 

nXDest ， 

//耘送先の矩形の左上隅の X 座標 

int 

nYDest, 

//耘送先の矩形の左上隅の y 座標 

int 

nWidth, 

//転送先の矩形の幅 

int 

nHeight, 

//転送先の矩形の高さ 

HDC 

hdcSrc ， 

//転送元のデバイスコンテキストのハンドル 

int 

nXSrc 、 

//転送元の矩形の左上隅の X 座標 

int 

n YSrc ， 

//転送元の矩形の左上隅の y 座標 

DWORD 

dwRop 

//ラスタオべレーションコード 


)； 

V B Declare Function BitBlt Lib ” gdi 32" Alias " BitBlt " (ByVal hDestDC As Long，ByVal x 

As Long , ByVal y As Long , ByVal nWidth As Long , ByVal nHeight As Long，ByVal 
hSrcDC As Long，ByVal xSrc As Long，ByVal ySrc As Long，ByVal dwRop As Long ) 
As Long 

パラメータ • hdcDest 転送先のデバイスコンテキストの識別子。 

• nXDest 転送先の矩形の左上隅の論理 x 座標を指定する。 

• nYDest 耘送先の矩形の左上隅の論理 y 座標を指定する。 

• nWidth 紜送先と転送元の矩形の幅を論理単位で指定する。 

• nHeight 転送先と転送元の矩形の高さを論理)} i 位で指定する。 
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ータの移動 


NT 


95 


gdi 32 .dll 


BitBlt 


Bitmao 


Windows プログラミングインターフェイスでのもっとも大きな位置を示す GUI 
に関する処理のほとんどを司るのがグラフィックデバイスインターフェイス 
( GDI ) 関数群である。 MS - DOS ともっとも大きくことなり、もっとも Windows 
らしい関数群である。 


2. d erapmc Device Interrace 

GDI インターフェイス 


2.5 GDI インターフ： 


gdkv?7h-\>4 
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• hdcSrc 転送元のデバイスコンテキストの識別子。 

• nXSrc 紜送元の矩形の左上隅の論理 x 座標を指定する。 

- nYSrc 耘送元の矩形の左上隅の論理 y 座標を指定する。 

• dwRop ラスタオペレーションコードを指定する。ラスタオペレーションコード 

とは、転送元の矩形の色データを、転送先の矩形の色データに結合す 
る方法を定義したものである。 

共通のラスタオペレーションコードは以下の通り。 



説明 

BLACKNESS 

物理ノ《ターンのインデックス〇の色で送先の矩形を塗りつぶす ( この色 
は、デフォルト物理パターンでは思である 

DSTINVERT 

fe 送先の矩形を反 fe する。 

MERGECOPY 

指定されたパターンビットマップと送元のビットマップをビットごとの 
AND 演镓で結合する。 

MERGEPAINT 

反皐云した fc 送元のビットマップと fc 送先のビットマップをビットごとの 
OR 演谅で結合する。 

NOTSRCCOPY 

反転した転送元のビットマップを転送先にコビーする。 

NOTSRCERASE 

fc 送先のビットマップと転送元のビットマップをビットごとの OR 演兑で 
結合し、その結米を反私させる。 

PATCOPY 

指定されたパターンビットマップを送先のビットマップにコビーする。 

PATINVERT 

送先のビットマップと指定されたパターンビットマップをビットごとの 
XOR 演镓で結合する。 

PATPAINT 

反した fc 送元のビットマップとパターンビットマップをビットごとの OR 
演兑で結合し、この結果と送先のビットマップをビットごとの OR 演笕 
で結合する。 

SRCAND 

fe 送先のビットマップと fc 送元のビットマップのビクセルをビットごとの 
AND 演兑で結合する。 

SRCCOPY 

転送元のビットマップを fe 送先のビットマップにコビーする。 

SRCERASE 

反した fc 送先のビットマップと fc 送元のビットマップをビットごとの 
AND 演算で結合する。 

SRCINVERT 

送先のビットマップと fe 送元のビットマップのピクセルをビットごとの 
XOR 演箅で結合する。 

SRCPAINT 

転送先のビットマップと送元のビットマップのピクセルをビットごとの 
OR 演铱で結合する。 

WHITENESS 

物理パターンのインデックス1の色で fc 送先の矩形を塗りつぶす(この色 
は、デフォルト物理パターンでは白である)。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー til 報は、 GetLastError 関数で取得。 

解 説 BitBlt 閲数は、指定されたデバイスコンテキストから転送先のデバイスコンテキスト 

に、ピクセル琳位の矩形のカラーデータを移®;する。 


154 



2.5 GDI インターフェイス 


V C HBITMAP CreateBitmap ( 

int n Width ， // ビットマップの幅 （ ピクセル） 

int nHeight ， // ビットマップの岛さ（ピクセル） 

UINT cPlanes ， //デバイスが使用するカラープレーンの数 

UINT cBitsPerPel //舉ーピクセル当たりのカラービットの数 

CONST VOID *lpvBits //カラーデータを持つ fid 列のポインタ 

)； 

V B Declare Function CreateBitmap Lib ” gdi 32" Alias " CreateBitmap " (ByVal nWidth As 

Long , ByVal nHeight As Long , ByVal nPlanes As Long , ByVal nBitCount As Long , 
IpBits As Any ) As Long 

パラメータ • nWidth ビットマップの幅をピクセル単位で指定する。 

• nHeight ビットマップの高さをピクセル舉位で指定する。 

• cPIanes デバイスにより使われるビットマップ中のカラープレーンの数を指 

定する。 

• cBitsPerPel 蜞ーピクセル当たりのカラービットの数を指定する。 

- IpvBits ピクセル単位の矩形の色を設定するために使う、カラーデータの配 

列へのボインタ。矩形の走査線ごとに WORD 単位で並ぶ (WORD 単 
位で並んでいない走査線は、0でうめられる)。このパラメータが 
NULL のときには、新しいビットマップは定義されない。 

戻り値 正常終了 ビットマップハンドル 

輿常終了 NULL 
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マップ作成 


NT 


95 


gdi 32 .dll 


CreateBitma 


配趵替えや分割の変換が、紅送元のデバイスコンテキストに影傅するとき、 BitBlt 関 
数はエラーを返す。他の変換が紜送元のデバイスコンテキストに存在するとき(かつ、 
その変換が転送先のデノ《イスコンテキストに影涔しないとき)、 fe 送先のデノ《イスコン 
テキストの矩形は必要に応じて縮小や拡大する。 

転送元と fe 送先のデバイスコンテキストのカラーフォーマットが異なる埸合 、 BitBlt 
関数は如送元のカラーフォーマットを奉云送先のフォーマットに変換して合わせる。 

エンハンストメタファイルが記録しているときに、転送元デバイスコンテキストがエ 
ンハンストメタファイルのデバイスコンテキストを認識するとエラーとなる。 

すべてのデバイスで BitBlt 関数がサポートされているわけではない 。 GetDeviceCapsTO 
数で RC _ BITB じ T ラスタを指定することにより、詳しい情報を調べること。 

送元と送先のデバイスコンテキストが違うデバイスであるとき、 BUBh 関数はエ 
ラーを返す。 

参 照 — GetDeviceCaps ， MaskBlt ， PlgBlt ，— StretchBlt 
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解 説 CreateBitmap 関数は、指定された幅、高さ、カラーフォーマット（カラー計画とピク 

セル当たりのビット数)を持つビットマップを作成する。 

作成されたビットマップは、 SelectObject 関数を使用してデバイスコンテキストとし 
て選択できる。 

アプリケーションのパフォーマンス向上のために、 CreateBitmap 閲数はカラービット 
マップを作成するために使用するのが望ましい。モノクロビットマップを作成する坳 
合には、 CreateCompatibleBitmap 関数を使用する 0 

カラービッ トマップがデバイスコンテキストより速択されて、 CreateBitmapI 對数より 
戻るとき、 Windows は逸択されたデバイスコンテキストのフォーマットに適合したビ 
ットマップであることを保証する。 

CreateCompatibleBitmap はデバイスコンテキストを取得し、指定されたデバイスコン 
テキストと M じフォーマットのビットマップを返す。この理山により 、 SelectObject |对 
数を呼び出した後で、カラービットマップを返すのは CreateBitmap 関数より V •い 0 
ビットマップがモノクロのときは、0が前景色に、1が紜送先のデバイスコンテキスト 
の背景色となる。 

アプリケーションカ、 WWf / i か尺/^パラメータに0を設定すると、 CreateBitmapI 划 
数はモノクロビットマップのハンドルを返す。ビットマップが必要なくなったら、 
DeleteObjectlW 数を使用してビットマップを削除する。 

参 照 CreateBitmapIndirect ，— CreateCompatibleBitmap ,— CreateDIBitmap ， DeleteObject ， 

— GetBitmapBits ， SelectObject，—SetBitmapBits 


CreateCompatibleBitmap 

gdi 32 .dll 

95 

NT 

デバイス互換ビットマップ作成 


V C HBITMAP CreateCompatibleBitmap ( 

HDC hdc ， // デバイスコンテキストの ハン ドル 

int nWxdtK //ビットマップの幅 （ ピクセル） 

int nHeight //ビットマップの高さ（ピクセル） 

)； 

V B Declare Function CreateCompatibleBitmap Lib " gdi 32” Alias "CreateCompati 

bleBitmap ” (ByVal hdc As Long，ByVal nWidth As Long，ByVal nHeight As Long ) As 
Long 


パラメータ 

•hdc 

デバイスコンテキストの識別子。 


• nWidth 

ビットマップの幅をビット単位で指定する。 


• nHeight 

ビットマップの高さをビット単位で指定する。 

戻り値 

正常終了 

ビツトマツプハンドル 


異常終了 

NULL 
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解 説 CreateCompatibleBitmapI 対数は、指足されたデバイスコンテキストに関連するデバイ 

スと互換性のあるビットマップを作成する。 

CreateCompatibleBitmap 関数により作成されたカラーの形式は 、 hdc パラメー タで識 
別されたデバイスと同じカラーの形式を持つ。このビットマップは、オリジナルデバ 
イスと互換性のある任意のメモリデバイスコンテキストより透択できる。 

メモリデハ•イスコンテキストでは、カラーのビットマップもモノクロのビットマップ 
も迸択できる0このため指定されたデバイスコンテキストがメモリデバイスコンテキ 
ストのとき、 CreateCompatibleBitmap 閲数が返すビットマップの形式と異なる。しか 
し、メモリデバイスコンテキスト以外のデバイスコンテキストの場合には、そのデバ 
イスと互換性のあるビットマップの形式は常に指定されたデバイスコンテキストカラ 
一の形式やカラーパターンと同じになる。 

アプリケーション A^nWidth 力、 nHeight ノ く ラメータに0を設定すると 、 CreateCompati 
bleBitmap _ 数は、モノクロビットマップのハンドルを返す 0 

办ふパラメータにより識別されるデバイスコンテキストから迸択されたビットマップが 
CreateDIBSection _数で作成された DIB セクションのとき 、 CreateCompatibleBitmap 
関数は DIB セクションを作成する。 

ビットマップが必要なくなったとき、 DeleteObject 関数を使用してビットマップを削 
除する。 

參 照 CreateDIBSection , DeleteObject,SelectObject 


CreateDIBitmap 

gdi 32 .dll 

95 

NT 

デバイス固有メモリビットマップ作成 


V C HBITMAP CreateDIBitmap ( 


HDC 

hdc ， 

// デバイスコンテキストのハンドル 

CONST BITMAPINFOHEADER * Ipbmih , 

//ビットマップのサイズとフォーマ 
ットデータへのポインタ 

DWORD 

fdwlnit . 

//初期化フラグ 

CONST VOID * 

Ipblnit ， 

/作刀期化データへのポインタ 

CONST BITMAPINFO * 

Ipbmi ， 

//ビットマップのカラー形式データ 
へのポインタ 

UINT 

fu Usage 

//カラーデータ 


)； 

V B Declare Function CreateDIBitmap Lib " gdi 32” Alias " CreateDIBitmap " (ByVal hdc As 

Long，lpInfoHeader As BITMAPINFOHEADER , ByVal dwUsage As Long，IpInitBits 
As Any，lplnitlnfo As B 1 TMAPINFO , ByVal wUsage As Long ) As Long 


GDIAV 必 17 ha>4 
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パラメータ 



解 脱 


參 照 


• hdc デバイスコンテキストの識別子。 

• Ipbmih BITMAPINFOHEADER 構造体へのポインタ。このパラメータは、 

CreateDIBitmap 関数による 0 

• fdwlnit ビットマップビットをオペレーションシステムが初期化する方法を指 

定するビットフラグの設定。以下の姑:がビットフラグに指定できる。 


説明 

CBMJNIT 

• Ipblnit ビットマ 、 

ツ トマ ツ 

INFOHE / 

• Ipbmi Ipblnit バ: 

る 、 BITN 

• fuUsage BITMAPI 

かノ《レツ 

ラメータ { 

オペレーティングシス 于ムが Ipbhut バラ メータと Ipbmi パラメー 
夕に指定されたビットを使用してビットマップを初期化すること 
を設定する。 fdw/nit が 0 のとき、 オペレーティングシステムは、 
ビットマップのビットを初期化しない。 

:/プデータの初期値を格納したバイト 况 列へのポインタ。ビ 
プ値の形式は、 Ipbmi パ ラメータに指定された BITMAP 
JDER 構造体の biBitCount / ンバにより決まる。 

ラメータにより示される配列の寸法とカラー形式を,记述す 
1 AP 1 NFO 構造体へのポインタ。 

NFO 構造体の tm / Co/m メンバが、み、緑、 M の ( RGB ) 値 
卜のインデックスのどちらを表すかを指定する。 fidJsage パ 
こは、以下の W のいずれかを指定する。 


説明 

DIB _ PAL_COLORS 

DIB . RGB_COLORS 

カラーテーブルは、 迸 択されたビットマップのデバイスコンテキ 
ストの 沿 神パレットへの 16 ビットインデックスの rtd 列である。 

カラーテーブルは、 RGB 4 ft である。 

正常終了 ビットマップハンドル 

異常終了 NULL 


CreateDIBitmap 関数は、デバイスに依存しないビットマップ ( DIB ) からデバイス固有 
のメモリビットマップを作成する。必要であれば、ビットマップ内のビットを設定す 
る。 

/ Av / m 7 パラメータが CBMJTREATDIB フラグのとき、これ以上サボートされない。 

ビットマップが必要なくなったとき、 DeleteObject 関数で削除する 0 

— BITMAFINFOHEADER ,— BlTMAPlNFO ， DeleteObject ，— GetDeviceCaps ， 

- ♦ GetSvstemPaletteEntries.SelectObject 
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ExtFloodFill 

gdi 32 .dll 

95 

NT 

指定範囲塗りつぶし 


V C 


BOOL ExtFloodFilK 
HDC 
int 
int 

COLORREF 

UINT 


hdc ， 

nXStart ， 

nYStart , 

crColor , 

fuFillType 


// デバイスコンテキストのハンドル 
//塗りつぶしの開始 X 座標 
//塗りつぶしの開始 y 座標 
//塗りつぶす色 
//塗りつぶしのタイプ 


V B 


パラメータ 


戻り値 


解 説 


Declare Function ExtFloodFill Lib ” gdi 32" Alias M ExtFloodFiH n (ByVal hdc As Long ， 
ByVal x As Long，ByVal y As Long , ByVal crColor As Long , ByVal wFillType As 
Long ) As Long 


•hdc 

• nXStart 

• n YStart 

• crColor 

• fuFillType 


デバイスコンテキストの識別子。 

塗りつぶしを開始する点の論理 X 座標を指定する。 

塗りつぶしを開始する点の論理 y 座標を指定する。 

塗りつぶす領域または境界の色を指定する。 crCV >/ or の意味は 
fuFillType パラメー タの値により決まる。 

塗りつぶし操作のタイプを指定する。以下の値の t ゝずれかになる。 




説明 

FIOODFIL し BORDER 

•脅りつぶす領域が、 crColo " ラメータで指定された色により囲 
まれている必贽がある。このスタイルは、 FloodFiH 関数による绝 
りつぶしと同じである。 

FLOODFILLSURFACE 

crCWw で指定された色の領域を塗りつぶす。指定された色が存 
在する限り、すべての方向に浼りつぶしが統けられる。枚数の色 
からなる境界の場合には、このスタイルが便利である。 

正常終了 

TRUE 


異常終了 

FALSE 



詳細なエラー情報は、 GetLastError により取得。 

ExtFloodFiU 関数は、画面上の指定された範囲をカレントブラシで塗りつぶす。 

以下の場合には、この関数は失敗する。 

• 塗りつぶしが完了しなかった。 

• 指定された点の色が crO / w パラメータで指定された境界色である （FLOOD 
FILLBORDER を指定したとき)。 

• 指定された点の色が crCo / or パラメータで指定された色でない （FLOOD 
FILLSURFACE を指定したとき)。 

•クリッビングリージョンの外の点が指定された6 


Gm-Kv 分 —7 ha>4 
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fuFillType パラメ ータが FLOODF 1 LLBORDER の場合、 Windows は塗りつぶす領域が 
crColor パラメ ータで 指定される色で完全にまれているものとみなす。この関数は、 
nXStart パラ メータと nYStart パラ メータにより指定される座標からすべての方向に塗 
りつぶしを始め、指定された色の付 t ゝた境界まで塗りつぶしを統ける。 
fuFillType パラ メータが FLOODFILLSURFACE の坳合には、 Windows は申.色で領域 
を塗りつぶすとみなす。この関数は，!;および/ 2 KS 如 r パこより指定される座標から 
すべての方向に後りつぶしを始め、 crCb / w で指定された色を含む隣接した領域を塗 
りつぶし統ける。 

メモリデバイスコンテキスト、およびラスタディスプレイをサボートするデバイスだ 
けが ExtFloodFilll 对数を サポートする。サポートするデバイスの 説明は 、 GetDevice 
Caps 閲数を参照。 

参 照 FloodFill,GetDeviceCaps 


FloodFill 

gdi 32 .dll 

95 

NT 

スクリーン領域塗りつぶし 

v c BOOL FloodFill ( 




HDC hdc , // デノ 

《イスコンテキストのハンドル 




int nXStart ， 

int nYStart , 

COLORREF crFill 

)； 


// 始点の x 座標 
// 始点の y 座挖 
//塗りつぶしの色 


V B 

パラメータ 


Declare Function FloodFill Lib ” gdi 32" Alias " FloodFill " (ByVal hdc As Long ， ByVa ! x 
As Long , ByVal y As Long，ByVal crColor As Long ) As Long 

•hdc デバイスコンテキストの識別子。 

• nXStart 途りつぶしを始める点の•論理 x 座標を指定する。 

- nYStart 飧りつぶしを始める点の論理 y 座摞を指定する。 

• crFill 塗りつぶし領域の境界の色を指定する。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怙報は、 GetLastErrorlftl 数により取得。 
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解 説 FloodFill 閲数は、カレントブラシを使用して、スクリーン表面の領域を塗りつぶす0 

塗りつぶされる領域は、 crF /// パラメータの指定通りに囲まれているものとみなされ 
る。 

FloodFiU 関数は Windows の初期バージョンとの互換性のためにのみ存在する。 Win 32 
ベースのアプリケーションは、 FLOODFILLBORDER を指定して ExtFloodFill 関数を 
使用すること。 

以下の埸合には、この閲数は失敗する。 

• 塗りつぶしが完了しなかった。 

• 指定された点の色が crf 7// パラメータで指定された境界色である。 

•クリッビングリージョンの外の点が指定された。 


参 照 - ♦ExtFloodFill 


GetBitmapBits 

gdi 32 .dll 

95 

NT 

ビットマップビットの コピー 


V C LONG GetBitmapBits ( 

HBITMAP hbmp， // ビットマップのハンドル 

LONG cbBuffer、 //バッファにコピーされるバイト数 

LPVOID IpvBits //ビットマップを受け取るバッファへのポインタ 

)； 


V B Declare Function GetBitmapBits Lib "§(1132" Alias ' GetBitmapBits " (ByVal hBitmap 

As Long , ByVal dwCount As Long，lpBits As Any ) As Long 


パラメータ 

• hbntp 

ビットマップの識別子。 


• cbBuffer 

コピーするバイト数を指定する。 


• IpvBits 

ビットマップのビットを受け取るバッファへのボインタ。ビットマップ 
はバイトの配列である。 

戻り値 

正常終了 

ビットマップサイズ（バイト琳位） 


輿常終了 

0 


詳細なエラー怡報は、 GetLastErrorlW 数により取得。 

解 説 GetBitmapBitsI 対数は、指定されたビットマップをバッファにコピーする。 

GetBitmapBits 関数は、 Win 32 API の関数ではない。この関数は、 Windows の16ビッ 
トバージョンの閲数である。 Win 32 ベースでは、アプリケーションは GetDIBits 関数 
を使用すること。 

バッファの中のビットは、 WORD 並びである。言い換えれば、バッファはメモリ上の 
偶数アドレスから始まる。 

参 照 —GetDIBits 
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GetBitmapDimensionEx 


、マップサイズ取得 


gdi 32 .dll 



NT 


V C BOOL GetBitmapDimensionEx ( 

HBITMAP hBitmap, II ビットマップのハンドル 

LPSIZE IpDimension //大きさの構造体へのポインタ 


V B Declare Function GetBitmapDimensionEx Lib M gdi 32" Alias n GetBitmapDimensionEx M 

(ByVal hBitmap As Long，IpDimension As SIZE ) As Long 

パラメータ • hBitmap ビットマッ プの識別 子。 

• IpDimension 寸法が返される SIZE 構造体へのポインタ。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー情報は、 GetLastErrorIJa 数により取得。 

解 税 GetBitmapDimensionEx 関数は、ビットマップの寸法を返す。この寸法は、 

SetBitmapDimensionEx 関数により設定される 。 GetBitmapDimensionEx 閲数は、 
GetBitmapDimension 閲数の代わりとなる 0 

この関数は、ビットマップの高さと幅の入った構造体を返す。寸法が設定されていな 
いときは、構造体のそれらの値に0を設定して返す。 

参 照 SetBitmapDimensionEx , SIZE 
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GetDIBColorTable 

gdi 32 .dll 

95 

NT 

RGB カラー値の回復 


V C 


V B 


パラメータ 


戻り値 


解 説 


参 照 


UINT GetDIBColorTable ( 

HDC hdc， 

UINT uStartlndex， 

UINT cEntries， 

RGBQUAD 々Colors 
)； 


// デバイスコンテキストのハンドル 
//回復するための M 初の入力のカラーテーブルイ 
ンデックス 

//冋復するための W 初の人力のカラーテーブルの数 
//カラー テーブルを受け取るバッフアへのボインタ 


Declare Function GetDIBColorTable Lib ” gdi 32" Alias " GetDIBColorTable ” (ByVal 
hDC As Long , ByVal uni As Long，ByVal un 2 As Long，pRGBQuad As RGBQUAD ) 
As Long 

• hdc デバイスコンテキストを指定する。 DIB セクションのビットマップ 

は、このデバイスコンテキストより迸択されなければならない。 


uStartlndex 

c entries 
piolors 


回復する M 初のカラーテーブル入力を指定する。0から始まるカラ 
ーテーブルインデツ クス。 

回復するカラーテーブル入力の数を指定する。 

DIB の カラー テーブルからの カラー t / f 報を入れる RGBQUAD 構造体 
の配列を受け取るバッファへのポインタ。このバッファは、 
RGBQUAD 構造体を扣 r / 打の値だけ人れるのに十分な大きさが必 
要である。 


正常終了 

異常終了 


カラーテーブル 入力 数 


0 


詳細なエラー愔報は GetLastError 関数により取得。 

GetDIBColorTablel 対数は、指定されたデバイスコンテキストで逸択された DIB セクシ 
ョンビットマップのカラーテーブルの入力範から RGB (赤、緑、青)のカラー値を回 
復する。 

GetDIBColorTable 関数は、ピクセル当たり丨、4または8ビットを使う DIB セクション 
ビットマップのカラーテーブルを回復するために呼び出される 。 BITMAPINFO 
HEADER 構造体の biBitCount メンバが、ピクセル当たりのビット数を示す 。 biBit 
Count の値が8より大きい DIB セクションビットマップは、カラーテーブルを持たない 
がカラーマスクに関連する〇カラーマスクの回復は、 GetObject _ 数を呼び出す。 

— B 1 TM APlNFOHEADER ， CreateDIBSection ，— DlBSECT 10 N ， GetObject ， 

― RGBOU AD ，— SetDIBColorTable 


GDI-fv 分 — 7h-\ >4 
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GetDIBits 

gdi 32 .dll 

95 

NT 

ビッ ト マップの 取得コピー 


V C 


V B 


パラメータ 


int GetDIBits ( 


HDC 

hdc. 

// デバイスコンテキストのハンドル 

HBITMAP 

hbmp. 

//ビットマップのハンドル 

UINT 

uStartScan ， 

"転送先ビットマップ内に設定される最初 
の走査線 

UINT 

cSccmunes, 

//コビーする走査線の数 

LPVOID 

IpvBits, 

//ビットマップビットの ftc ! 列のアドレス 

LPBITMAPINFO 

Ipbi, 

//ビットマップデータの構造体のアドレス 

UINT 

uUsage 

//RGB または、 ハ。 ターンのインデックス 


)； 


Declare Function GetDIBits Lib n gdi 32 n Alias " GetDIBits " (ByVal aHDC As Long ， 
ByVal hBitmap As Long，ByVal nStartScan As Long , ByVal nNumScans As Long ， 
lpBits As Any，lpBI As BITMAPINFO , ByVal wUsage As Long ) As Long 


• hdc デバイスコンテキストの識別子。 

• hbmp ビット マップの 識別子。 

• uStartScan 設定される W 初の走査線を指定する。 

• cScanLines コピーする走査線の数を指定する。 

• IpvBits ビッ ト マップデータを 受け取る バッファの ボイ ンタ。このパラメータ 


が NULL のとき、この関数は//^/•パラメータが指す BITMAPINFO 構 
造体にビットマップの大きさやフォーマットを設定する。 

• Ipbi デバイスに依存しないビットマップ ( DIB ) データのフォーマットを指 

定する BITMAPINFO 構造体へのポインタ。 

• uUsage BITMAP 1 NFO 構造体の bmiColors メンバのフォーマットを指定する。 


このパラメ 

一夕は、以下の値のいずれかである。 


总味 

DIB _ PAL_COLORS 

カラーテーブルは、カレント論理パレットへの 16 ビットのインデ 


ックスの fll ! 列である。 

DIB_RGB 一 COLORS 

カラーテーブルは、赤、緑、が ( RGB ) の W である。 
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正常終 r(Windows 95) lpvBits =0 

ビットマップの走杏線数 

正常終了 ( WindowsNT ) lpvBits =0 

0以外 

異常終了 

0 


解 説 GetDIBits 関数は、指足されたビットマップのビットを取得し、それをデバイスに依 

存しな t 、形式で/ / n 必治パラメータが指す バッファ にコピーする。 

DIB のために要求された形式が内部形式に合っていれば、ビットマップの RGB 値が 
コピーされる。要求された形式が内部形式に合っていないと、カラーテーブルが統合 
される。以下がその値である。 



意味 

\_BPP 

カラーテーブルは、黒と白の入力からなる。 

4 _BPP 

カラーテーブルは、 抒 •ザ VGA パターンと N じ色を浞ぜたものか 
らなる。 

8 _BPP 

カラーテーブルは、 GDI で定義された256色を混ぜたものからな 
る (256 色には、デフオルト 論 押パレットの20色が含まれる)。 

24 一 BPP 

カラーテーブルは返されない。 


IpvBits パラメータがポイ ンタが設定されているとき、 BITMAPINFOHEADER 構造体 
の M 初の6 メンバは、 DIB のサイズと形式を指定して初期化する。ボトムアップ DIB 
は正の数で高さを設定し、トップダウン DIB は負の数で萵さを設定する。このビット 
マップのカラーテーブルは、 BITMAPINFO 構造体に追加される。 

IpvBits パラメ ータが NULL のとき、 GetDIBits 関数は/ 〆 ?/で示される M 初の構造体の 
M 初のメンバを検査する。このメンバには、 B 1 TMAPINF 0 HEADER または BITMAP 
COREHEADER 構造体のバイト単位のサイズを指定する。この関数は、残りのメン 
， 《の初期化の方法を決定するため指定されたサイズを使う。 

/ pvfi / ry パラメータが NULL で、 BITMAPINFO 構造体の川メンバが0で初期化 
されていてかつ、 カラー テーブルがないとき、 GetDIBits _ 数は BITMAP 
INFOHEADER または B 1 TMAPCOREHEADER で塗りつぶす。このテクニックは、ビ 
ットマップの域性を確認するために使う。 

アプリケーションがこの_数を呼び出すとき、パラメータにより認識されるビッ 
トマップは、デバイスコンテキストの中を選択してはならない。ボトムアップ DIB の 
原点はビットマップの左下隅である。トップダウン DIB の原点は左上隅である。 

参照 — BITM APCOREHEADER ，— BITM AP 1 NF 0，— BITM APINFOHEADER ，— SetDIBits 
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GetPixel 

指定位置のカラー値取得 


gdi32.dll 


95 


NT 


V C COLORREF GetPixel ( 


HDC 

hdc ， 

// デバイスコンテキストのハンドル 

int 

nXPos ， 

//ピクセルの X 座標 

int 

nYPos 

//ピクセルの y 座標 


V B Declare Function GetPixel Lib " gdi 32” Alias " GetPixel " (ByVal hdc As Long , ByVal x 

As Long，ByVal y As Long ) As Long 


パラメータ 

• hdc 

• nXPos 

• nYPos 

デバイス コンテ キストの識別子。 

調査するピクセルの論理 X 座搮を指定する。 

調奄するピクセルの論理 y 座標を指定する。 

戻り値 

正常終了 

RGB 値 


ピクセルがクリ 

ッビング領域外 CLR_INVALID 

解 説 

GetPixel 関数は、指定された位 [ S にあるピクセルの赤、緑、青 ( RGB ) カラー値を取得 
する0 


ピクセルは、カレントクリッビング領域内になければならない。 

GetPixel 関数をサポートしていないデバイスもある。アプリケーションは、指定され 
たデバイスがこの関数をサポートしているデバイスか GetDeviceCaps 関数を呼び出し 
確認すること。 

参 照 —GetDeviceCaps 


166 







2.5 GDI インターフェイス 


V 

C 

V 

B 

パラメ 

ータ 

戻り 

値 

解 

説 


int UetbtretchbltMcxle( 

HDC hdc // デバイスコンテキストのハンドル 

)； 

Declare Function GetStretchBltMode Lib "gdi32" Alias "GetStretchBItMode" (ByVal 
hdc As Long) As Long 


hdc 


デバイスコンテキストの識別子, 


正常終 r 
異常終 r 


ごットマツブ仲縮モード 


0 


参 照 


GetStretchBltMode 関数は、カレントビットマップ伸縮モードを取得する。ビットマ 
ップ仲縮モードとは、 StretchBlt 関数を使用してビットマップを圧縮するときに、 
報を削除する方法を定義するものである。 

— SetStretchBltMode,-^ StretchBlt 


V C 


V B 


ノ\•ラメータ 


戻り値 


HBITMAP LoadBitmap( 

HINSTANCE hlnskmce, // アプリケーションインスタンスのハンドル 
LPCTSTR IpBitmapName // ビットマップリソース名へのポインタ 
)； 

Declare Function LoadBitmap Lib "user32" Alias "LoadBitmapA" (ByVal hlnstance As 
Long, ByVal IpBitmapName As String) As Long 

• hlnstance ロードするビットマップを持つ実行可能ファイルを含む モジュ 

ールのインスタンスの識別子。 

• IpBitmapName ロードするビットマップリソースの名前の NULL で終わる文字 

列へのポインタ。また、この パラメータには、 下位 ワードに リ 
ソース 識別子を設定し、上位 ワードに 0 を設定することもで 
きる。この値は 、 MAKEINTRESOURCE マクロを 使用して作成 
できる。 


正常終 r 
異常終了 


ビットマップのハンドル 

NULL 


LoadBitmap 

user32.dll 

95 

NT 

ビットマップリソースロード 


GetStretchB It Mode 

gdi32.dll 

95 

NT 

ビットマップ伸縮モード取得 


% 

: 


: 

: 


GDI AV 必 17 H へ >4 
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解 説 


参 照 


LoadBitmap 関数は、モジュールの実行可能ファイルから、指定されたビットマップ 
リ ソースを 口ー ドす る。 

IpBitmapName が示すビットマップがな t 、埸合や、ビットマップをロー ドするためのメ 
モリが不足している場合、関数は失敗する。 

アプリケーションは LoadBitmap 関数を使用して、 Win32API が使用する定義済みビッ 
トマップにアクセスできる。定義済みビットマップにアクセスするには、アプリケー 
ションは hlnstance パラメータに NULL を設定し、 IpBitmapName パラメータに以卜の 
値のいずれかを設定する。 


OBM.BTNCORNERS 
OBMJBTSIZE 
OBM 一 CHECK 
OBM.CHECKBOXES 
OBM-CLOSE 
OBM 一 COMBO 
OBM_DNARROW 
OBM 一 DNARROWD 
OBM_DNARROWI 
OBM_LFARROW 
OBM.LFARROWD 
OBM LFARROWI 


OBM.MNARROW 
OBM 一 OLD-CLOSE 
OBM_OLD_DNARROW 
OBM_OLD_LFARROW 
OBM 一 OLD—REDUCE 
OB M 一 OLD_RESTORE 
OBM 一 OLD 一 RGARROW 
OBM_OLD_UPARROW 
OBM 一 OLD-ZOOM 
OBM.REDUCE 
OBM 一 REDUCED 
OBM RESTORE 


OBM_RESTORED 

OBM.RGARROW 

OBM.RGARROWD 

OBM_RGARROWI 

OBM-SIZE 

OBM.UPARROW 

OBMJJPARROWD 

OBM.UPARROWI 

OBM.ZOOM 

OBM 一 ZOOMD 


OBM_OLD で始まるビットマップ名は、 Windows 3.0 以前のバージョンで使われてい 
たビットマップを表している。 

OBM_ 定数を使うアプリケーションでは、 WINDOWS.H ヘッダーファイルをインクル 
ードする前に OEMRESOURCE 定数を定義する 0 アプリケーションは、 DeieteObject 
関数を呼び出して、 LoadBitmap 関数が返した各ビットマップハンドルを削除しなけ 
ればならない。 


—CreateBitmap，DeleteObject，LoadCursor，LoadIcon，—MAKEINTRESOURCE 
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SetBitmapBits 

gdi32.dll 

95 

NT 

ビットマップから色データ設定 


V C LONG SetBitmapBits( 

HBITMAP hbmp, // ビツトマツプのハンドル 
DWORD cBytes ， //ビットマップ配列内のバイト数 
CONST VOID* IpBits //ビットマップビットを格納している配列へのポインタ 
)； 


V B Declare Function SetBitmapBits Lib "gdi32” Alias "SetBitmapBits" (ByVal hBitmap As 

Long，ByVal dwCount As Long，IpBits As Any) As Long 


パラメータ 

• hbmp 

設定するビットマップの識別子。 


• cBytes 

! P Bifs パラメータが指すビッ トのバイト数を指定する。 


• IpBits 

指定されるビットマップの色データのバイト配列へのポインタ。 

戻り値 

正常終了 

設定で利用したサイズ（バイト単位） 


異常終了 

0 


解 脱 SetBitmapBits_ 数は、指定されたビットマップのビットを色データのビット蛸に設定 

する。 

SetBitmapBits 関数は、 Windows の初期のバージョンに適合するために含まれている。 
Win32 ベースのアプリケーションでは、 SetDIBitsI 対数を使用すること。 

/ 尸忍 / びで示される配列は、 WORD 並びである。 

参 照 —GetBitmapBits,— SetDIBits 
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SetBitmapDimensionEx 

gdi32.dll 

95 

NT 

ビットマップ優先サイズ割り当て 


V C 


V B 


パラメータ 



解 説 


参 照 


BOOL SetBitmapDimensionEx( 


HBITMAP 

hBitmap, 

// ビットマップの ハン ドル 

int 

nWidth, 

//0.1mm 取位のビットマップの幅 

int 

nHeigh し 

I / O . 1 mm 取位のビットマップの高さ 

LPSIZE 

)； 

IpSize 

// オリジナルの、 J •法が格納される構造体のアドレス 


Declare Function SetBitmapDimensionEx Lib M gdi32 M Alias M SetBitmapDimensionEx M 
(ByVal hbm As Long, ByVal nX As Long，ByVal nY As Long，IpSize As SIZE) As 
Long 

• hBitmap ビットマップの識別子。このビットマップは、 DIB ビットマップで 

はない。 

• n Width ビットマップの幅を 0.1 ミリメー トル取位で指定する。 

• nHeight ビットマップの高さを 0. 1 ミリメートル中位で指定する。 

• IpSize ビットマップの以前の寸法を格納する SIZE 構造体へのボインタ。こ 

のポインタは、 NULL でもかまわない。 


正常終了 TRUE 

輿沿終了 FALSE 

，详細なエラー怙報は、 GetLastError I 対数で取得。 

SetBitmapDimensionEx I 対数は、ビットマップの礙先される寸法を ; 1 り 、 1 1 てる。これ 
らの寸法は、アプリケーションでのみ使われ、 Windows は使わない。 

アプリケーションは 、 GetBitmapDimensionEx 1 对数を呼び出すことにより 
SetBitmapDimensionEx I 划数でビットマップの;切り当てられた寸法を回似することが 
できる。 

hBitmap で示 されるビットマップは、 CreateDIBSection 開数で作られたビットマップ 
である DIB セクションではない。ビットマップが DIB セクションのとき 、 SetBitmap 
DimensionEx 関数は失敗する。 

CreateDIBSection ， —GetBitmapDimensionEx,—SIZE 
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SetDIBColorTable 

gdi32.dll 

95 

NT 

ビットマップからカラー値設定 


V C 


V B 


パラメータ 


戻り値 


解 説 


参 照 


UINT SetDIBColorTable( 


HDC 

hdc ， 

UINT 

uStartlndex, 

UINT 

cEntries ， 


CONST RGBQUAD* pColors 
)； 


// デバイスコンテキストの ハン ドル 
// 設定するための M 初の入力のカラーテー 
ブルインデックス 

// 設定するための!初の入力のカラーテー 
ブルの数 

//カラーテーブルの K 列のポインタ 


Declare Function SetDIBColorTable Lib "gdi32” Alias "SetDIBColorTable” (ByVal 
hDC As Long, ByVal uni As Long, ByVal un2 As Long，pcRGBQuad As RGBQUAD) 
As Long 


• hdc 


• uStartlndex 

• cEntries 

• pColors 


デバイスコンテキストを指定する。デバイスに依存しないビット 
マップは、このデバイスコンテキストより透択されなければなら 
ない 0 

設定する W 初のカラーテーブル入力を指定する、 0 から始まる力 
ラーテーブルインデッ クス。 

設定するカラーテーブル入力の数を指定する。 

DIB の カラー テーブルからの新しい カラー 情報を入れる 
RGBOUAD 構造体の配列へのポインタ。 


正常終了 カラーテーブル 入力数 

異常終了 0 

詳細なエラー怡報は GetLastError 関数により取得 0 


SetDIBColorTable 関数は、指定されたデバイスコンテキストで選択されたデバイスに 
依存しないビットマップ (DIB) のカラーテーブルの入力範囲から、 RGB ( 赤、緑、青 ) 
のカラー値を設定する。 

この関数は、ピクセル当たり 1 、 4 または 8 ビットを使うデバイスに依存しないビット 
マップのカラーテーブルを設定するために呼び出される。 BITMAPINFOHEADER 構 
造体の biBitCount メンバが、ピクセル当たりのビット数を示す。 biBitCount の値が 8 
より大きいデバイスに依存しないビットマップは、カラーテーブルを持たない。 



—BITMAPINFOHEADER ， CreateDlBSection ， —GetDIBColorTable ， GetObject ， 
— DIBSECTION,— RGBOUAD 
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SetDIBits 


、マップ か 


V C 


gdi32.dll 



NT 



ータ設定 


int SetDIBits( 

HDC 

HBITMAP 

UINT 

UINT 

CONST VOID* 


hdc, 
hbmp, 
uSt art Scan, 
cScanLineSy 
IpvBits, 


CONST BITMAFINFO* IpbmL 


// デバイスコンテキストのハンドル 
//ビットマップのハンドル 

//開始走査線 
//開始走査線 

//ビットマップビットの配列 

//ビッ ト マップデータの 梢造体の アドレ 


UINT 


fuColorUse //使用するカラーインデックスのタイプ 


V B 


パラメータ 


Declare Function SetDIBits Lib "gdi32" Alias "SetDIBits" (ByVal hdc As Long, ByVal 
hBitmap As Long，ByVal nStartScan As Long，ByVal nNumScans As Long，lpBits As 
Any, lpBI As BITMAPINFO, ByVal wUsage As Long) As Long 


hdc 

hbmp 


uStartScan 


cScanLines 


IpvBits 


Ipbtni 

fuColorUse 


デバイスコンテキストの識別子。 

指定された DIB よりカラーデータを使用するビットマップの識別 
子。 

IpvBits パラメータが指す fill 列のデバイスに依存しないカラーデー 
夕の W 初の走査線を指定する。 

デバイスに依存しないカラーデータを含む ftt ! 列の走査線数を指定 
する。 

バイト配列として格納されている、 DIB カラーデータへのポイン 
夕。ビットマップ値の形式は、パラメータが指す 
BITMAPINFO 榊造体の iii 初のメンバである /^/ 7CV 皿 j / メンバの肮 
により異なる。 

DIB についての W 報を持つ、 BITMAPINFO 構造体へのポインタ。 
BITMAPINFO 構造体の bmiColors メンバに、赤、鉍、青 (RGB ) の 
値が格納されているのか、またはパレットへのインデックスが格納 
されているのかを指定する。このパラメータは、以下の値のいず 
れかになる。 


DIB PAL COLORS 


DIB RGB COLORS 


总味 _ 

カラーテーブルは、址バラメータが識別するデバイスコンテキ 
ストの益理パレットへの、 16 ビットインデックスの K 列である。 

カラーテーブルは RGB 値である。 
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戻り値 

正常終了 

コピーされた走杏線数 


異常終了 

0 


詳細なエラー情報は、 GetLastEnwl 划数により取得。 

解 脱 SetDIBits 関数は、ビットマップのピクセルをデバイスに依存しないビットマップ 

(DIB) で指定されるカラーデータに設定する。 

ビットマップを描画するときの速度は、各ビットマップビットがシステムパレットを 
参照しているときに W 適化される。 

アプリケーションは GetSystemPaleueEntries 関数によりシステムバレツトの色とイン 
デックスを回復できる。色とインデックスの回復後、アプリケーションは DIB を作成 
できる 0 システムパレットについて詳しくは SystemPalette を参照すること 0 
fuColorUse パラメータに DIB_PAL_COLORS が設定されているとき、デバイスコンテ 
キストは / w/c パラメータにより識別する。それ以外は無视される。 

アプリケーションがこの関数を呼び出すとき、パラメータにより識別されるビッ 
トマップは、デバイスコンテキストの中を選択してはならない。 

ボトムアップ DIB の原点はビットマップの左下隅である。トップダウン DIB の原点は 
左 I: 隅である。 

参 照 —B1TMAPINF0，—GetSystemPaleueEntries 


SetDIBitsToDevice 

gdi32.dll 

95 

NT 

ビットマップから矩形ピクセルを設定 


V C 


int SetDIBitsToDevice( 


HDC 

hdc ， 

int 

XDest, 

int 

YDest. 

DWORD 

dwWidth y 

DWORD 

dwHeight ， 

int 

XSrc, 

int 

YSrc ， 

UINT 

uStartScan ， 

UINT 

cScanLines, 

CONST VOID* 

lpvBits % 

CONST BITMAPINFO* 

Ipbmi, 

UINT 

fuColorUse 

)； 



//デバイスコンテキストのハンドル 

// 転送先の矩形の左上点の x 座標 
// 転送先の矩形の左上点の y 座挖 
//転送元の矩形の幅 
//転送元の矩形の高さ 
// 転送元の矩形の左下点の x 座標 
//fc 送元の妬形の左下点の y 座標 
//ftt! 列中の W 初の走査線 
//走査線の数 

//DIB ビットの配列のアドレス 

// ビットマップ M •報の構造体へのポインタ 

//RGB 値またはパレットインデックス 
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V B 


パラメータ 


戻り値 


Declare Function SetDIBitsToDevice Lib ”gdi32" Alias "SetDlBitsToDevice" (ByVal 
hdc As Long，ByVal x As Long，ByVal y As Long，ByVal dx As Long，ByVal dy As 
Long，ByVal SrcX As Long, ByVal SrcY As Long，ByVal Scan As Long，ByVal 
NumScans As Long, Bits As Any Bitlnfo As BITMAPINFO, By Val wUsage As Long) 
As Long 


•hdc デバイスコンテキストの識別子。 

• XDest 転送先の矩形の左上点の論理単位の x 座標を指定する。 

• YDest 転送先の矩形の左上点の論理举位の y 座標を指定する。 

• dwWidth DIB の幅を論理単位で指定する。 

• dwHeight DIB の高さを論理単位で指定する。 

• XSrc DIB の左下点の論理华位の x 座標を指定する。 

• YSrc DIB の左下点の論理単位の y 座挖を指定する。 

• uStartScan DIB の開始走査線を指定する。 

• cScanLines IpvBits パラ メータの配列内の DIB 走査線数を指定する。 

• IpvBits バイト配列として格納されている、 DIB カラーデータへのポインタ。 

• Ipbmi DIB に関する情報を持つ、 BITMAPINFO 構造体へのポインタ。 

- fuColorUse BITMAPINFO 構造体の bmiColors メンバに、赤、緑、青 (RGB ) の値 

が格納されているのか、またはパレットへのインデックスが格納され 
ているのかを指定する。このパラメータは、以下の値のいずれかに 


なる。 

値 

意味 

DIB _ PAL_COLORS 

カラーテーブルは、カレント論理パレットへの、 16 ビットインデ 


ックスの fid 列である。 

DIB _ RGB 一 COLORS 

カラーテーブルは RGBtf (である。 


正常終了 設定された走査線数 

異常終了 0 

詳細なエラー情報は、 GetLastError 関数で取得 0 
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v c COLORREF SetPixel( 


HDC 

hdc ， 

// デバイスコンテキストのハンドル 

int 

X ， 

//ピクセルの X 座標 

int 

Y, 

//ピクセルの y 座標 

COLORREF 

crColor 

//ピクセルの色 


)； 

V B Declare Function SetPixel Lib ,, gdi32 ,, Alias "SetPixel" (ByVal hdc As Long，ByVal x 

As Long，ByVal y As Long，ByVal crColor As Long) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• X 設定する位置の 論理 x 座標を指定する。 

- Y 設定する位闾の 論理 y 座標を指定する。 

• crColor 指定された位厲に描画するときの色を指定する。 


ピクセル色設定 


NT 


95 


gdi 32 .dll 


SetPixel 


解説 SetDIBitsToDevice 関数は、デバイスに依存しないビットマップ (DIB) から、カラーデ 

一夕を使用するデバイスコンテキストに関連したデバイス上に指定された矩形にピク 
セルを設定する。 

ビットマップを描両するときの速度は、各ビットマップビットがシステムパレット参 
照しているときに敁適化される。 

アプリケーションは、 GetSystemPaletteEntries 関数によりシステムパレットの色とイ 
ンデックスを回復できる。色とインデックスの回復後、アプリケーションは DIB を作 
成できる。システムパレットに ついて 詳しくは Colors を参照すること。 

ボトムアップ DIB の原点はビットマップの左下隅である。トップダウン DIB の原点は 
左上隅である。アプリケーションでデバイスの画面上にある大きなデバイスに依存し 
ないビットマップからビットを設定するときは、 SetDIBitsToDevice 閲数を繰り返し 
呼び出し、ビットマップ全体を別々に//びバッファの中に読み取ることにより必要 
なメモリ fit を節約できる。 uStartScan パラメータと cScanLines パラメータは 、 IpvBits 
ftli 列内にある、ビットマップ全体の特定の部分を識別する値になる。フォアグラウン 
ドで全画面の MS-DOS セッションの実行中、バックグラウンドで実行している処理か 
ら呼ばれた埸合、 SetDIBitsToDevice 関数はエラーを返す。 

参照 — BITM APINFO，— GetSystemPaletteEntries，— SetDIBits，— StretchDIBits 


GDK v T VJ Hi 
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戻り値 

正常終了 

設定された RGB 値 


興常終了 

-1 


詳細なエラー柄•報は、 GetLastErrorl 划数により取得。 

解 説 SetPixel 関数は、指定された座標にあるピクセルを指定の色に設定する。 

指定された点がクリッビングリージョン内にないときは、この閲数は失敗する。 
すべてのデバイスが SetPixel 関数をサボートするとは限らない。 GetDeviceCaps 関数 
によりデバイスを調べること。 

参 照 — GetDeviceCaps，—SetPixel V 


SetPixelV 


95 

NT 

ピクセル色設定 


V C BOOL SetFixelV ( 


HDC 

hdc % 

// デハ•イスコンテキストのハンドル 

int 

X ， 

//ピクセルの X 座標 

int 

K 

//ビクセルの y 座標 

COLORREF 

crColor 

//新しいピクセルの色 


)； 


パラメータ 

• hdc 

描画するために使う色を指定する。 


• X 

設定する位押の論理 X 座挖を指定する。 


- Y 

設定する位趵の論理 y 座標を指定する。 


• crCoior 

指定された位置に描_するときの色を指定する。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


“ T 細なエラ ー 報は、 GetLastErrorliy 数で取得。 

解 説 SetPixelVl 対数は、指定された座標に、指定された色にできるだけ近い色でピクセル 

を設定する。そのピクセルは、クリッピングリージョンとデバイスの表面の見える部 
分になければならない。すべてのデバイスが SetPixelV 関数をサボートするとは限らな 
い。 GetDeviceCaps 関数の RC _ B 1 TBUT で調査すること。 

描幽された点のカラー値を返す必费がないため、 SetPixelV 閲数は SetPixel 関数より早 

い0 

参照 — GetDeviceCaps ，— SetPixel 
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V C 


V B 


パラメータ 


戻り値 


解 説 


int SetStretchBltMode ( 

HDC hdc ， 
int iStretchMode 
)； 


// デバイスコンテキストの ハン ドル 
//ビットマップの f 中縮モード 


Declare Function SetStretchBltMode Lib " gdi 32" Alias " SetStretchBltMode " (ByVal hdc 
As Long , ByVal nStretchMode As Long ) As Long 


hdc 

iStretchMode 


デバイスコンテキストの識別子。 

仲縮モードを指定する。このパラメータは、以下の値のいずれ 
かとなる。 



意味 

BLACKONWHITE 

縮小化によってビットマップのラインが消去されるときに。 
AND 演を用いてライン結合を/ f/ •う。 I'lM {のビットマップ 
の坳合、このモードでは、广 1 色のビクセルが消えて規色のピ 
クセルが残る。 

COLORONCOLOR 

ピクセルを削除する。このモードでは、尨理演は行わずに 
消去するラインをすべて削除する。 

HALFTONE 

送先の拓形のピクセルのブロックに送元の拓形からビク 
セルを纪於する。 tern 色は、 fc 送允のピクセルの色に近い色 
で、 fc 送先のピクセルのブロックを上•來りする。アプリケー 
ションは仲縮モードに HALFTONE の,没定後、ブラシの点 
を•设定するため SetBrushOrgEx 関数を呼ばなければならない。 
それが失敗した坳合、ブラシは％れない。 

STRETCH 一 ANDSCANS 

Windows 95 では、 BLACKONWHITE と M じ。 

STRETCH_DELETESCANS 

Windows 95 では、 COLORONCO し OR と M じ。 

STRETCH_HALFTONE 

Windows 95 では、 HALFTONE と |»il じ。 

STRETCH 一 ORSCANS 

Windows 95 では、 WHITEONBLACK と M じ。 

WHITEONBLACK 

編小化によってビットマップのラインが淌去されるときに。 
OR 演•を用いてライン結合を行う。のビットマップ 
の場合、このモードでは、煱色のピクセルが消えて色 N •きま 
たは白色のピクセルが残る。 


正常終了 
輿常終了 


伸縮モードの値 
0 


SetStretchBltMode 閲数は、指定されたデバイスコンテキストのビットマップの伸縮モ 
ー ドを設定する。伸縮モードは、 StretchBlt 関数を使用して表示デバイス上にあるピ 
クセル墘位のビットマップの行や列を Windows が結合する方法を定義するものであ 
る0 


SetStretchBltMode 

gdi32.dll 

95 

NT 

ビットマップ伸縮モード設定 


GDIAV 分 — VJH A yJ 
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B 常、 BLACKONWHITE ( STRETCH _ ANDSCANS ) モードおよび WHITEON 
BLACK ( STRETCHJDRSCANS ) モードは、 モノクロ ビットマップ内の前景 ピクセルを 
残すときに使う。また、 COLORONCOLOR ( STRETCH _ DELETESCANS ) モードは、 
カラービットマップ内の色を残すときに使われる。 HALFTONE モードは、他の3補 
のモードより軺送元イメージの加工をすることを要求する。高さや品質のイメージを 
加工するため他の処理より遅い。 HALFTONE モードを設定された後で呼び出される 
SetBrushOrgEx 関数では、パフォーマンスに注意する。 

追加された伸縮モードではパフォーマンスは、デバイスドライバの能力の信頼性を高 
める。 

参照 — SetBrushOrgEx ，— StretchBlt 


StretchBlt 

gdi32.dll 

95 

NT 

ビットマップの矩形領域コピー 


V C 


V B 


パラメータ 


BOOL StretchBlt ( 

HDC 

hdcDest ， 

//車云送先のデバイスコンテキストのハンドル 

int 

nXOriginDest ， 

//奉ム送先の矩形の左上隅の X 座標 

int 

n YOriginDest, 

// fe 送先の矩形の左上隅の y 座標 

int 

nWidthDest ， 

//転送先の矩形の幅 

int 

nHeightDest ， 

//転送先の矩形の高さ 

HDC 

hdcSrc, 

//転送元のデバイスコンテキストのハンドル 

int 

nXOriginSrc ， 

//転送元の矩形の左上隅の X 座標 

int 

nYOriginSrc ， 

// fc 送元の矩形の左上隅の y 座標 

int 

nWidthSrCy 

//率云送元の矩形の幅 

int 

nheightSrc ， 

//聿云送元の矩形の高さ 

DWORD 

dwRop 

//ラスタオべ レーシヨンコード 


)； 


Declare Function StretchBlt Lib " gdi 32 M Alias " StretchBlt " (ByVal hdc As Long , ByVal 
x As Long，ByVal y As Long , ByVal nWidth As Long，ByVal nHeight As Long，ByVal 
hSrcDC As Long，ByVal xSrc As Long，ByVal ySrc As Long , ByVal nSrcWidth As 
Long，ByVal nSrcHeight As Long，By Val dwRop As Long ) As Long 


• hdcDest 

• nXOriginDest 

• nYOriginDest 

• nWidthDest 

• nHeightDest 

• hdcSrc 

• nXOriginSrc 

• n YOriginSrc 


fe 送先のデバイスコンテキストの識別子。 
fc 送先の矩形の左上隅の論理 x 座標を指定する。 
fc 送先の矩形の左上隅の論理 y 座標を指定する。 
転送先の矩形の幅を論理単位で指定する。 
転送先の矩形の岛さを論理単位で指定する。 

送元のデバイスコンテキストの識別子。 

転送元の矩形の左上隅の論理 x 座標を指定する。 
転送元の矩形の左上隅の論理 y 座標を指定する。 
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• nWidthSrc 送元の矩形の幅を論理単.位で指定する。 

• nHeighiSrc 耘送元の矩形の高さを論理增位で指定する。 

- dwRop 実行するラスタオペレーションを指定する。ラスタオペレーショ 

ンコードは、 Windows が現在のブラシ、送元のビットマップ、 
送先のビットマップを組み合わせて出カオペレーションの色を 
生成する方法を定義する。共通ラスタオペレーションコードは、 
BitBU 関数を参照。 


戻り値 

正常終 r 

TRUE 


異常終了 

FALSE 


詳細なエラー tfJ •報は、 GetLastError I 対数により取以。 

解 説 StretchBItIJy 数は、元の矩形領域から別の矩形領域へビットマップをコピーする。ま 

た、必翅であれば、送先の矩形に合うようにビットマップを拡大または縮小してコ 
ピーする。 Windows は、如送先のデバイスコンテキストの仲縮モード使⑴して、ビッ 
トマップを拡人•また小する。 

StretchBklW 数は、メモリ上で虹送元のビットマップを拡大または縮小し、その結果 
を転送先の矩形にコピーする。パターンのカラーデータをこの結采とマージするとき 
は、拡大された fc 送元のビットマップが私送先にコピーされるまでマージされない。 
エンハンストメタフアイルのときに、松送元デバイスコンテキストがエンハンストメ 
タフアイルのデバイスコンテキストを識別すると、エラーが発生する(1«数が FALSE 
を返す)。 

指定されたラスタオペレーションがブラシの坳作、 Windows で使われるブラシは、率 z '; 
送先のデバイスコンテキスト内で遗択されたブラシである。 

虹送先の崦挖は、私送先のデバイスコンテキストに合わせて変換される。如送元の座 
標は、 fc 送元のデバイスコンテキストに合わせて変換される。 
fe 送元の変換が、配竹替えゃ分沏であるとエラーが発生する。 

fc 送先のビットマップ、送元のビットマップ、パターンビットマップのカラー形式 
が異なる坳合、 StretchBlt 関数は、杬送先のビットマップに合わせて送元のビット 
マップとパターンビットマップのカラー形式を変換する。 

StretchBhl 対数で モノクロの ビットマップを カラーに 変換するときには、白のビット （1) 
を背景色に、黒のビット⑼を前设色に設定する。 カラーの ビットマップを モノクロに 
変換するときには、竹] Tc 色を白のビット （1) に、他の色を患のビット (0) に設定する。 
この前说色と背景色には、紅送先のデバイスコンテキストのものが使われる。 

Stretch B 1 1 閲数は 、" Widthsrc ヒ n WidthDest ^ または nHeightSrc ヒ nHeightDest の各パ 
ラメータの符号が異なるときに、ビットマップのミラーイメー ジを作成する。 
nWidthSrc パラメー タヒ nWidthDest パラメ ータの符号が輿なるときは、 x 座標に沿っ 
てビットマップのミラーイメー ジを作成する。 nHeightSrc パラメータと nHeigfuDext パ 
ラメータの符号が異なるときは、 y 座標に沿ってビットマップのミラーイメージを作 
成する。すべてのデバイスで S じ etchBIt 閲数がサポートされているわけではない。 
GetDe viceCaps 関数で詳し I ゝ M 報を取得すること。 

参 照 — BitBlt ，— GetDeviceCaps , MaskBlt , PlgBlt，—SetS は etchBltMode 


179 


第 2 章 Win 32 API リファレンス 


StretchDIBits 

gdi 32 .dll 

95 

NT 

ビッ ト マップの 矩形領域コピー 


V C 


V B 


パラメータ 


int StretchDIBits ( 

HDC 

int 

int 

int 

int 

int 

int 

int 

int 

CONST VOID * 

CONST BITMAPINFO * 

UINT 

DWORD 


hdc ， // デバイスコンテキストのハンドル 

XDesu //転送先の左 I •.隅の矩形の x 座挖 
YDest, // fc 送先の左ヒ隅の矩形の y 座挖 
nDestWidth, //fc 送先の矩形の幅 
nDestHeight % //fc 送先の矩形の高さ 
XSrc 、 //私送元の左上隅の矩形の x 座標 

YSrc, // fc 送元の左上隅の矩形の y 座挖 

nSrcWidth ， //耘送元の矩形の幅 
nSrcHeight, //転送元の矩形の高さ 
IpBits, // ビットマップビットへの ポ インタ 

IpBitslnfo 、 //ビッ トマップデータへの ポ インタ 
iUsage, //使用法 

dwRop //ラスタオペレーションコード 


)； 


Declare Function StretchDIBits Lib " gdi 32" Alias " StretchDIBits " (ByVal hdc As Long , 
ByVal x As Long，ByVal y As Long，ByVal dx As Long , ByVal dy As Long，ByVal 
SrcX As Long , ByVal SrcY As Long , ByVal wSrcWidth As Long，ByVal wSrcHeight 
As Long，lpBits As Any，IpBitsInfo As BITMAPINFO , By Bal wUsage As Long，By 
Val dwRop As Long ) As Long 


•hdc 送先のデバイスコンテキストの識別子。 

• XDest 送先の矩形の左上隅の論理 x 座標を指定する。 


• YDest 

• nDestWidth 

• nDestHeight 
- XSrc 



• nSrcWidth 

• nSrcHeight 

• lpBits 

• IpBitsInfo 


送先の対 i 形の左上隅の，論理 y 座標を指定する。 

送先の矩形の幅を論理琳位で指定する。 

送先の矩形の高さを論理単位で指定する。 

DIB 内の送元の矩形の x 座掠をピクセル琳位で指定する。 
DIB 内の軺送元の矩形の y 座標をピクセル蝌位で指定する。 
DIB 内の軚送元の矩形の幅をピクセル琳位で指定する。 

DIB 内の fe 送元の矩形の灯さをピクセル取位で指定する。 
バイト配列として格納される DIB ビットへのポインタ。 

DIB に I 対する情報を含む BITMAPINFO 構造体へのポインタ。 
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• iUsage BITMAPINFO 構造体の bmiColors メンバが用总されているか、赤、 

緑、青 ( RGB ) の値が格納されているのかを指定する。このパラメー 
夕は、以下の値のいずれかになる。 



意味 

DIB _ PAL_COLORS 

カラーテーブルは、軚送元のデバイスコンテキストの論坪パレッ 
卜への 16 ビットのインデックスのだ列である。 

DIB _ RGB_COLORS 

カラーテーブルは、 RGB W である。 


- dwRop 送元のピクセル、私送先のデバイスコンテキストのカレントブ 

ラシ、ピクセルを組み合わせて新しいイメージを生成する方法を 
衍定する。衍定できる倘は、 BitBU 関数の共通ラスタオペレーシ 
ョンコードを参照すること。 


戻り値 

正常終了 

コピーされた走査線数 


異常終了 

GDI ERROR 


詳細なエラー怙報は、 GetLastErroi •開数により取得。 

解 説 StretchDIBits 閲数は、デバイスに依#しないビットマップ ( DIB ) の矩形のカラーデータ 

を、送先の炻形領域にコピーする。 fc 送先の矩形が fc 送元の矩形より大きい場介 
は、虹送先の矩形に合うようにカラーデータの“さや幅を拡大する。も;送先の妬形が 
丰ム送元の矩形より小さ t ゝ埸合は、指定されたラスタオペレーションで卨さや幅を縮小 
する。 

ボトムアップの DIB の原点は左下隅になる。トップダウンの DIB の原点は左 I •.隅にな 
る 。 StretchDIBitsliy 数は、 nSrcWidth ヒ nDestWUith 、 または nSrcHeight ヒ nDextHeigftt 
の各パラメータの符号が輿なるときに、ビットマップのミラーイメージを作成する。 
nSrcWidth パラメー タと nDestWidth パラメ ータの符号が異なるときは、 x 座標に沿っ 
てビットマップのミラーイメージを作成する。 nSrcHeight パラメー タヒ nDestHeight パ 
ラメータの符号が異なるときは、 y 座標に沿ってビットマップのミラーイメージを作 
成する。 

参照 — SetMapMode ，— SetStretchBltMode ，— BITMAPINFO 
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Brush 






CreateBrushlndirect 

gdi32.dll 

95 

NT 

論理ブラシ作成 


v c HBRUSH CreateBrushIndirecK 

CONST LOGBRUSH* Iplb //ブラシ厲性の構造体へのポインタ 

)； 

V b Declare Function CreateBrushlndirect Lib ”gdi32" Alias •CreateBrushlndirect” 

(IpLogBrush As LOGBRUSH) As Long 


パラメータ .Iplb ブラシに _ する情報を持つ LOGBRUSH 構造体のポインタ。 


戻り値 

正常終了 

論理ブラシの識別子 


與常終了 

NULL 


解 説 CreateBrushlndirect I 対数は、指定されたスタイル、色、パターンを持つぬ理ブラシを 

作成する。ブラシは Windows が塗りつぶしに使うビットマップである。 

アプリケーションは CreateBrushlndirect 閲数で作成したブラシを SelectObjectlSJ 数を使 
うことで、どのようなデハ•イスコンテキストでも使用できる。 

モノクロビットマップ(ピクセル当たり1つのプレーン、1つのビットを持つ)を使用し 
て作成されたブラシは、カレントテキストの色と背设色を使用して描幽される。ビッ 
卜が0に設定されたピクセルはカレントテキストの色で描_され、ビットが1に設定さ 
れたピクセルは現在の背欺色で描_される。 

/〆 わにより指される LOGBRUSH 構造体の IbStyle メンバが BS_PATTERN のとき、 
IbHatch メンバにより指されるビットマップは、 DIB セクションにはならない。 DIB セ 
クションは、 CreateDibSection 関数により作成されたビットマップである。ビットマ 
ップが、 DIB セクションであると、 CreateBrushlndirect 関数は失敗する。 

論理ブラシが必费なくなったとき 、 DeleteObject №1数を使用してブラシを削除しなけ 
ればならない。 

参 照 CreateDibSection,DeleteObject,-^GetBrushOrgEx,-^LOGBRUSH,SelectObject, 

― SetBrushOrgEx 
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V c 


V B 


/ マラメータ 


HBRUSH CreateDIBPattemBrush( 

HGLOBAL hglbDlBPacked . //デバイスに依存しないビットマップのハンドル 
UINT fuColorSpec // カラーテーブルデータ 
)； 

Declare Function CreateDIBPattemBrush Lib ”gdi32” Alias 'CreateDIBPattemBrush" 
(ByVal hPackedDIB As Long，ByVal wUsage As Long) As Long 


hglbDIB Packed 


fuColorSpec 


DIB PAL COLORS 


DIB RGBCOLORS 


デバイスに 依存しないパックされた DIB を含む グローバルメモリ 
オブジェクトの識別子。パックされた DIB は、 BITMAPINFO 構 
造体と、その直後に統くビットマップの各ピクセル数を定義す 
る バイ ト fid 列で構成される。 Windows 95 では、ビットマップま 
たは、 DIB から 8 X 8 ピクセルより大きなブラシを作成すること 
はサポートしていない。大きなビットマップが指定された埸合、 
ビットマップの一部だけが使用される。 

BITMAPINFO 構造体の bmiColors メンバが、赤、緑、 rf(RGB) 
の値と、現在実体化されている論理パレットへのインデックス 
のどちらを表すかを指定する。 fuColorSpec パラメータ I こは、以 
下の値の t ゝずれかを指定する。 

カラーテーブルは、 18 択されたブラシのデバイスコンテキストの 
益理 パレットへの 16 ビットインデックスの fill 列。 

； カラーテーブルは、 RGB 说 である。 


戻り値 


正常終了 

異常終了 


論理ブラシのハンドル 

NULL 


CreateDIBPattemBrush 閲数は、デバイスに依存しないビットマップ (DIB) により指定 
されたパターンを持つ、論理ブラシを作成する。このブラシは、ラスタオペレーショ 
ンをサポートするすべてのデバイスで透択できる。 

この関数は、 Windows3.0 以前のバージョンで記述されたアプリケーションとの互換 
性のために用怠されている。 Win32 ベースのアプリケーションでは、 
CreateDIBPattemBrushPt 関数を使用する。 

アプリケーシヨンがモノクロデバイスコンテキストの中に 2 色の DIB パターンブラシを 
選択した場合、 DIB で指定される色は無視され、現在の背景色とデバイスコンテキス 
卜の前景色によるパターンブラシが表示される。 DIB の®初の色 (DIB カラーテーブル 
のオフセット 0) に割り当てられるピクセルは、前贵色を使用して表示され、2番目の 
色(カラーテーブルのオフセット 1) に割り当てられるピクセルは、背设色を使用して表 
示される。 
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CreateDIBPattemBrush 


gdi32.dll 


NT 


95 
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論理ブラシが必要なくなったとき、 DeleteObject 関数を使用してブラシを削除しなけ 
ればならない。 

参照 — B 1 TM AP 1 NFO ，— CreateDIBPatternBrushPt ,-^ CreateHatchBrush , 

— CreatePattemBrush ，— CreateSolidBrush ， DeleteObject ， SetBkColor，—SetTextColor 


CreateDIBPattemBrushPt 

gdi 32 .dll 

95 

NT 

論理ブラシ作成 


V C 


V B 

パラメータ 



解 説 


参 照 


HBRUSH CreateDIBPattemBrushPt ( 

CONSTVOID * IpPackedDIB ，// 構造体とビットマップビットのポインタ 
UINT (Usage //使用法フラグ 

)； 

Declare Function CreateDIBPattemBrushPt Lib M gdi 32” Alias "CreateDIBPattern 
BrushPt " (IpPackedDIB As Any , ByVal iUsage As Long ) As Long 


• IpPackedDIB B 1 TMAP 1 NF 0 構造体と、そのめ:後に続くビットマップの各ピクセ 

ル数を定義するバイト配列で構成される DIB へのボインタ。 
Windows 95では、ビットマップまたは DIB から8 X 8ピクセルよ 
り大きなブラシを作成することはサポートしていない。大きなビッ 
トマップが指定された坳合、ビットマップの一部だけが使用される。 

• iUsage B 1 TMAPINFO 構造体の bmiColors メンバが、赤、鉍、 i * f ( RGB ) の 

値と、現在実体化されている論理パレットへのインデックスのど 
ちらを表すかを指定する。パラメータには、以下の侦のい 
ずれかを指定する。 


m 

意味 

DIB_PAL 一 COLORS 

カラーテーブルは、 迸択 されたブラシのデバイスコンテキストの 
，沿理 パレットへの 16 ビットインデックスの 配列。 

D1B_RGB 一 COLORS 

カラーテーブルは、 RGBlift: である。 


正常終了 論理ブラシの識別子 

異常終了 NULL 


CreateDIBPattemBrushPtlJy 数は、デバイスに依存しないビットマップ ( DIB ) により衍 
定されたパターンを持つ論理ブラシを作成する。 

ブラシは Windows が塗りつぶしに使うビットマップである。 

アプリケーションは CreateDIBPattemBrushPt 関数で作成したブラシを SelectObject 閲 
数を使うことでどのようなデバイスコンテキストでも使用できる。 

論理ブラシが必要なくなったときは、 DeleteObject 関数を使用してブラシを削除する。 

- *BITM APINFO ，— CreateDIBPattemBrush ，— CreateHatchBrush ，— CreatePattemBrush , 
— CreateSolidBrush ， DeleteObject ，— GetBrushOrgEx ， SelectObject ，— SetBrushOrgEx 
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CreateHatchBrush 

gdi32.dll 

95 

NT 

論理ブラシ作成 


V C 


V B 

パラメータ 



解 脱 


参 照 


HBRUSH CreateHatchBrush ( 

int fnStyle , // ハッチスタイル 

COLORREF clrref //色の値 

)； 

Declare Function CreateHatchBrush Lib ” gdi 32" Alias " CreateHatchBrush " (ByVal 
nlndex As Long，ByVal crColor As Long ) As Long 


- fnStyle ブラシのハッチスタイルを 指定す る。このパラメータは、 以 ドの肮 

のいずれかである。 


m 

总味 

HS 一 BDIAGONAL 

45 度上向きの左から右へのハッチ 

HS 一 CROSS 

水平と垂丨 ft のクロスハッチ 

HS.DIAGCROSS 

45 度のクロスハッチ 

HS 一 FD1AGONA し 

45 度下向きの左から右へのハッチ 

HS_HORIZONTAL 

水、 ド-ハッチ 

HS 一 VERTICAL 

垂直 ハッチ 


• clrref ハッチに使うブラシの前说色を指定する。 


正常終了 論理ブラシのハンドル 

輿常終了 NULL 

CreateHatchBrush 関数は、指定されたハッチパターンと色を持つ論理ブラシを作成す 
る。ブラシは Windows が塗りつぶしに使うビットマップである。 

アプリケーションは CreateHatchBrush _数で作成したブラシを SelectObjectl 对数を使 
うことでどのようなデバイ スコンテキスト でも使用できる。 

アプリケーションが調和した色で親ウィンドウと子ウィンドウのず f 设色を塗りつぶす 
ためにハッチブラシを使うとき、子ウィンドウの背设色を塗る前にブラシの原点を設 
定する必费がある。これは、アプリケーションで SetBrushOrgExI 対数を呼び出すこと 
により行われる。アプリケーションは、 SetBmshOrgEx 関数を呼び出すことにより力 
レントブラシの原点を取得できる。ブラシが必要なくなったときは 、 DeleteObject \9 i 
数により削除する。 


— CreateDIBPattemBrush ，— CreateDlBPattemBrushPt ，— CreatePatternBrush ， 

— CreateSolidBrush ， DeleteObject ，— GetBrushOrgEx ， SelectObject，—SetBrushOrgEx 
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CreatePattemBrush 

gd_32.dll 

95 

NT 

論理ブラシ作成 


V C HBRUSH CreatePattemBrush ( 

HBITMAP hbmp // ビットマップのハンドル 

)； 


V 0 Declare Function CreatePattemBrush Lib M gdi 32 M Alias " CreatePattemBrush " (ByVal 

hBitmap As Long ) As Long 


パラメータ 

• nomp 

論理ブラシを作成するために使用するビットマップの識別子。 
Windows 95では、ビットマップまたは DIB から8 X 8ピクセルより大 
きなブラシを作成することはサポートしていない。大きなビットマッ 
プが指定された埸合、ビットマップの一部だけが使用される。 

戻り値 

正常終了 

論理ブラシの識別子 


異常終了 

NULL 


解 説 CreatePattemBrush 関数は、指定されたビットマップパターンを持つ論理ブラシを作 

成する。このビットマップは、 CreateDIBSection 関数で作成された DIB ではならない 0 
ブラシは Windows が塗りつぶしに使うビットマップである。 

アプリケーションは CreatePattemBrush 関数で作成したブラシを SelectObject 関数を使 
用することでどのようなデバイ スコンテキスト でも使用できる。 

DeleteObject 関数を使用して関連するビットマップに対して影湃を与えずにパターン 
ブラシを削除できる。つまり、同じビットマップを使用してパターンブラシをいくつ 
でも作成することができる。 

モノクロ ビットマップ(ピクセル当たり1つの プレーン、 1つのビットを持つ)を使用し 
て作成されたブラシは、現在のテキストの色と背景色を使用して描画される。ビット 
が0 に 設定されたピクセルは カレン トのテキストの色で描画され、ビットが1 に 設定さ 
れたピクセルは カレン トの背撰色で描画される。 

んゎ m 尸により識別されるビットマップは、 CreateDIBSection 関数により作成されたビッ 
トマップである DIB セクションではない。ビットマップが、 DIB セクションであった 
場合は、 CreatePattemBrush 関数は失敗する。 

参 照 — CreateBhmap ， CreateBitmaplndirect ，— CreateCompatibleBitmap ， 

— CreateDIBPattemBrush ，— CreateDIBPaUemBrushPt ， CreateDIBSection ， 

— CreateHatchBrush ， DeleteObject ，— GetBrushOrgEx ，— LoadBitmap ， 

SelectObject ，— SetBrushOrgEx 
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CreateSolidBrush 

gdi32.dll 

95 

NT 

論理ブラシ作成 


V C HBRUSH CreateSolidBrush ( 

COLORREF crColor // ブラシの色 


V B Declare Function CreateSolidBrush Lib " gdi 32" Alias " CreateSolidBrush " (ByVal 

crColor As Long ) As Long 


パラメータ 

• crColor 

ブラシの色を指定する。 

戻り 値 

正常終了 

論理ブラシの識別子 


異常終了 

NUL し 


解 脱 CreateSolidBrush 関数は、指定された純色 ( solidcolor ) のブラシを作成する。作成され 

たブラシは任总のデバイスのカレントブラシとして選択できる。ブラシは Windows が 
後りつぶしに使うビットマップである。 

アプリケーションは CreateSolidBrush I 划数で作成したブラシを SelectObjectl 对数を使う 
ことでどのようなデバイスコンテキストでも使用できる。 

参 照 —^ CreateDIBPattemBrush ,-* CreateDIBPattemBrushPt ,-^ CreateHatchBrush , 

— CreatePattemBrush ， DeleteObject，SelectObject 


GDIAV 必 17 HAyJ 
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GetBrushOrgEx 

gdi32.dll 

95 

NT 

カレントブラシの原点取得 


V C BOOL GetBrushOrgEx ( 

HDC hdc \ // デバイスコンテキストのハンドル 

LPPOINT Ippt //原点の構造体へのアドレス 

)； 


V B Declare Function GetBrushOrgEx Lib " gdi 32" Alias " GetBrushOrgEx ” (ByVal hDC As 

Long，IpPoint As POINTAPI ) As Boolean 


パラメータ 

• hdc 

• ippt 

デバイスコンテキストの識別子。 

ブラシの原点のデバイス座標が返される POINT 構造体へのポインタ。 

戻り値 

正斯終了 

TRUE 


興常終了 

FALSE 


詳細なエラー 

怡報は、 GetLastErrorIJy 数により取得。 


解 説 GetBrushOrgEx 関数は、指定されたデバイスコンテキストのカレントブラシの原点を 

取得する。この関数は、 GetBrushOrgliy 数に代わるものである。ブラシは Windows が 
途りつぶしに使うビットマップである。ブラシの原点は、ビットマップの中の丨ピク 
セルの位 IK を指定する0から7の問の fii * (の座標である。デフォルトのブラシの原点は、 
座掠(0,0)である。水平方向の座標で、硝〇はピクセルの W も左に位趵し、侦7は W も 
右に位趵する。垂商方向の座標で、 W 0 はピクセルの W も h に位！？?し、 f め:7は M も下 
に位! W する。 Windows は、どのような描 I 由 i 操作においてもクライアント領域の中にブ 
ラシの原点を配趵して開始位趵を決定する。例えば、 K 〖点を(2,3)に設定すると、 
Windows はクライアント領域のブラシの(0,0)を原点として(2,3)の位殷に配 ll v f する。 
アプリケーションが調和した色で親ウィンドウと子ウィンドウの背景色を飧りつぶす 
ためにブラシを使うとき、子ウィンドウの竹设色を描_する前に親ウィンドウを描闹 
し、ブラシの原点を設定する必要がある。 

WindowsNT では、オペレーティングシステムが、ウィンドウ操作するデバイスコンテ 
キストの原点を自勋的にトレースし、表 Ifij のパターン列を維持するのに必赀なブラシ 
を適応させる。 

Windows 95では、ブラシの原点の自勋的なトレースはサポートされていない。アプ 
リケーシヨンは、ブラシを使う前に UnrealizeObject 、 SetBrushOrgEx 、 SelectObject|jy 
数を使わなければならない。 

参照 — PCHNT ， SelectObject ，— SetBrushOrgEx ，— UnrealizeObject 


188 







2.5 GDI インターフ 


GetSysColorBrush 

user32.dll 

95 

NT 

論理ブラシハン i 

ドル取得 


V C HBRUSH GetSysColorBrush ( 

int nlndex // システムカラーインデックス 

)； 


V B Declare Function GetSysColorBrush Lib M user 32 f, Alias M GetSysColorBrush M (ByVal 

nlndex As Long ) As Long 


パラメータ 

• nlndex 

カラーインデックスを指定する。この倘は、21制あるウィンドウの構成 
赀索(アクティブ/非アクティブウィンドウのタイトルバーの色など)の1つ 
を描くために使う色と同じである。 

戻り値 

正常終了 

論理ブラシの識別子 


異常終了 

NULL 


詳細なエラー怡報は、 GetLastError 関数により取得。 

解 説 GetSysColorBrush 間数は、カラーインデックスを指定するために対応する論理ブラシ 

のハンドルを検索する。ブラシは、 Windows が塗りつぶされた図形の内側を描両する 
ために使うビットマップである。アプリケーションは、 GetSysColor 関数を呼び出す 
ことにより、カレントシステムカラーを検索できる。また、アプリケーションは Set 
SysColors 関数を呼び出すことにより、カレントシステムカラーを設定することができ 
る。 

アプリケーションは、ウインドウがシステムブラシを使うためウインドウクラスを登 
鉍してはならない。 

参 照 GetSysColor,SetSysColors 


SetBrushOn 

ブラシ原点の設定 



V C BOOL SetBrushOrgEx ( 


HDC 

hdc ， 

int 

nXOrg ， 

int 

nYOrg , 

LPPOINT 

lppt 


)； 


//デバイスコンテキストのハンドル 
//新しい原点の X 座標 
//新しい原点の y 座標 

//以前のブラシの原点を指定する構造体へのボイ 
ンタ 


V B Declare Function SetBrushOrgEx Lib M gdi 32 f, Alias " SetBrushOrgEx ” (ByVal hdc As 

Long , ByVal nXOrg As Long，ByVal nYOrg As Long，lppt As POINTAPI ) As Long 
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パラメータ 

• hdc 

デバイスコンテキストの識別子。 



• nXOrg 

デバイス墘位で、新しいブラシの原点の X 座標を指定する。 

0から7の範囲内である。 

この値は、 


• nYOrg 

デバイス¥位で、新しいブラシの原点の y 座標を指定する。 

0から7の範囲内である。 

この値は、 


• Ippt 

以前のブラシの原点を受け取る POINT 構造体へのポインタ。以前のブ 
ラシの原点が必要でないときは、このパラメータは NULL でかまわな 
い。 

戻り信 

正常終了 

異常終了 

TRUE 

FALSE 



詳細なエラー惜報は、 GetLastErrorIJy 数で取得 0 

解 脱 SetBmshOrgEx 関数は、指定されたデバイスコンテキストよりアプリケーションが迸 

択したブラシのために GDI が割り当てたブラシの原点を設定する。この関数は、 
SetBrushOrg 関数に代わるものである。ブラシはオペレーティングシステムが塗りつ 
ぶしに使うビットマップである。ブラシの原点は、ビットマップの中の丨ピクセルの 
位置を指定する0から7の問の値の座標である。デフォルトのブラシの原点は、座標 
(0,0)である。水平方向の座標で、値〇はピクセルの W も左に位跋し、値7は iii も右に 
位置する。垂直方向の座標で、値0はピクセルの W も上に位 IW し、値7は W も下に位 
趵する。 

Windows は、どのような描画操作のブラシの開始位; H を決定するときも、指定され 
るクライアント領域の中の位 IS へブラシの原点を配! S する。たとえば、原点を(2,3)に 
設定すると、 Windows はクライアント領域のブラシの(0,0)を原点として(2,3)の位！ W に 
配置する。 

オペレーティングシステムが、ウィンドウ操作するデバイスコンテキストの原点を自 
勁的にトレースし、表面のパターン列を維持するのに必要なブラシを適応させる。こ 
のブラシの原点は、クライアントエリアの左上隅に設定される。 

アプリケーションは、 SetStretchBltMode 関数によりビットマップを HALFTONE モー 
ドに設定した後で、 SetBrushOrgEx 閲数を呼び出すべきである。 

WindowsNT では、オペレーティングシステムが、ウィンドウ操作するデバイスコンテ 
キストの原点を自動的にトレースし、表面のパターン列を維持するのに必要なブラシ 
を適応させる。 

Windows 95では、ブラシの原点の自勋的なトレースはサポートされていない。アブ 
リケーションは、ブラシを利用する前に UnrealizeObjectx SetBrushOrgEx、Select 
Object 関数を使わなければならない。 

参照 — GetBrushOrgEx ，— P 01 NT ， SelectObject ，— SetStretchBltMode ，— UnrealizeObject 
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Clipping 


ExcludeClipRect 

gdi32.dll 

95 

NT 

既存のクリッピングリージョンから新規リージョン作成 


V C 


V B 


パラメータ 


戻り値 

解説 

参 照 


int ExcludeClipRect( 


HDC 

hdc ， 

int 

nLeftRect y 

int 

nTopRect, 

int 

nRightRect, 

int 

nBottomRect 

)； 



//デバイスコンテキス トの ハンドル 
//矩形の左上隅の X 座標 
//矩形の左上隅の y 座標 
//矩形の右下隅の x 座挖 
//矩形の右下隅の v 座標 


Declare Function ExcludeClipRect Lib ”gdi32" Alias "ExcludedipRect" (ByVal hdc As 
Long, ByVal XI As Long, ByVal Y1 As Long, ByVal X2 As Long, ByVal Y2 As 
Long) As Long 


•hdc デバイスコンテキストの識別子。 

• nUftRect 矩形の左上隅の論理 x 座行:を指定する。 

• nTopRect 矩形の左上隅の論理 y 座標を指定する。 

• nRightRect 矩形の右下隅の論理 x 座挖を指定する。 

• nBottomRect 矩形の右下隅の論理 y 座校を指定する。 


I 対数が正常に終了した場合は、新いゝクリッビングリージョンのタイプを示す値を返 
す。戻り破は、以下の肮のうち丨つである。 


NULLREGION 

リージョンは空。 

SIMPLEREGION 

リージョンは、琳一の矩形である。 

COMPLEXREGION 

リージョンは、槐数の矩形である。 

ERROR 

リージョンは、作成されない。 


ExcludeClipRect 閲数は、既存のクリッビングリージョンから指定された矩形の領域 
を除いて、新しいクリッビングリージョンを作成する。 

指定された矩形の右下隅は、クリッビングリージョンから出ない。 


― IntersectClipRect 
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ExtSelectClipRgn 

gdi32.dll 

95 

NT 

クリッピングリージヨンの結合 


V C 


int ExtSelectClipRgn ( 
HDC 
HRGN 
int 

)： 


hdc ， 

hrgn ， 

fnMode 


// デバイスコンテキストのハンドル 
//リージョンのハンドル 

//リージョン遗択モード 


V B 

パラメータ 


Declare Function ExtSelectClipRgn Lib " gdi 32” Alias " ExtSelectClipRgn " (ByVal hdc 
As Long，ByVal hRgn As Long，ByVal fnMode As Long ) As Long 


•hdc デバイスコンテキストの識別子。 

• hr^n 選択されたリージョンの識別子。 fiMode に RGN _ COPY を指定した坳 

このハンドルは NULL である。 

• fnMode 実行される操作を指定する。以下の値のうち I つを指定する。 


tft 总味 

RGN.AND 新しいクリッビングリージョンは、カレントクリッビングリージョンの領 

域に屯なる。そのリージョンは、 / ir がで識別される。 


RGN COPY 


RGN.DIFF 
RGN 一 OR 
RGN XOR 


新しいクリッビングリージョンは、 / i / t ^ で識別されるリージョンのコピー 
である。これは、 SelectClipRgn と M じである。 / irw により識別されたリ 
ージョンが NULL のとき、新しいクリッピングリージョンは、デフォルト 
のクリッビングリージョンとなる(デフォルトのクリッビングリージョンは、 
空のリージョンである)。 

新しいクリッビングリージョンは、により識別されたリージョンに含 
まれないカレントのクリッビングリージョンの領域と結合する。 

新しいクリッビングリージョンは、カレントのクリッピングリージョンと 
結合する。そのリージョンは、 /» r が!により,裁別される。 

新しいクリッビングリージョンは、カレントのクリッピングリージョンと 
結合する。そのリージョンは、“以!により涵別されるが、 T (なった領域は 
含まない。 


民リ値 №1数が正常に終了した場合は、新しいクリッピングリージョンのタイプを示す侦を返 

す。戻り値は、以下の値のうち1つである。 


NULLREGION 

リージョンは空。 

SIMPLEREGION 

リージョンは、単一の矩形である。 

COMPLEXREGION 

リージョンは、複数の矩形である。 

ERROR 

エラーが 発生した。 
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解説 ExtSelectClipRgn 関数は指定されたモードで、カレントのクリッビングリージョンと 

指定されたリージョンを結合する。 

この間数が呼び出されてエラーが発生したとしても、指定されたデバイスにおける以 
前のクリッビングリージョンに影涔はない。 

hrgn パラメータで識別されるリージョンのコピーだけが使用される。呼び出された 
後、このリージョン自分は再度使用されるか削除される。 

参 照 - ♦SelectClipRgn 

GetClipBOX 一 gdi32.dll 95 NT 

矩形サイズの取得_ 

V C int GetClipBox ( 

HDC hdc ， //デバイスコンテキス トの ハンドル 

LPRECT Iprc //矩形の構造体の アドレス 

)； 

V B Declare Function GetClipBox Lib " gdi 32" Alias " GetClipBox ’’ (ByVal hdc As Long , 

IpRect As RECT ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

•Iprc 対 i 形の寸法を受け取る RECT 構造体へのポインタ。 

戻り値 1划数が正你に終了した場合は、クリッピングボックスのタイプを示す侦を返す 。 m 

り M は、 以下の値のうち丨つである。 

NULLREGION リージョンは空。 

SIMPLEREGION リージョンは、単一の矩形である。 

COMPLEXREGION リージョンは、构数の矩形である。 

ERROR エラーが発生した。 

GetClipBox 関数は、 デバイスコンテキストに基づいた 論理座標を返す。 

解説 GetClipBox 関数は、デバイス上の目に見える領域を_む般小の矩形の寸法を取得す 

る。目に見える領域は、カレントクリッピングリージョンやクリップパスや重なって 
いるウィンドウにより定義される。 

参照 —RECT 
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GetClipRgn 

gdi32.dll 

95 

NT 

クリッビングリージヨン識別用のハンドル取得 


V C 


V B 

パラメータ 


戻り僅 


解説 


参 照 


int GetClipRgn ( 

HDC hdc , // デバイスコンテキストのハンドル 

HRGN hrgn // リージョンのハンドル 

)； 

Declare Function GetClipRgn Lib " gdi 32" Alias " GetClipRgn ” (ByVal hdc As Long ， 
ByVal hRgn As Long ) As Long 

- hdc デバイスコンテキストの識別子。 

• hrgn この 関数が呼び出される以前に存在する リージョンを 識別する。関数が 

戻った後、このパラメータはカレントクリッビングリージョンのコピー 
を識別する。 

正常終了 クリッピングリージョンが存在しない場合 0 

正常終了クリッピングリージョンが存在する場合 1 

異常終了 -1 

GetClipRgn 関数は、指定され たデバイスコンテキストのカレントアプリケーション 定 
義 のクリ ッ ビングリージョンを 識別する ハンドルを 取得する。 

アプリケーション定義のクリッピングリージョンは 、 SelectClipRgn _数により識別 
されるクリッピングリージョンである。 BeginPaint 関数により作成されたクリッピン 
グリージョンではない。 

関数が正常に終了した場合、 パラメータはカレントクリッビングリージョンのコ 
ピーを 識別する。 このコピーの 変更は カレントクリ ッ ビングリージョンには 影響しな 


— BeginPaint ，— SelectClipRgn 
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2.5 GDI インターフ] 


V C int GetMetaRgn ( 

HDC hdc ， // デバイスコンテキストのハンドル 

HRGN hrgn // リージョンのハンドル 

)； 

V B Declare Function GetMetaRgn Lib M gdi 32" Alias " GetMetaRgn .’ (ByVal hdc As Long ， 

ByVal hRgn As Long ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• hrgn この 閲数が呼び出される以前に存在する リージョンを 識別する。関数が 

戻った後、このパラメータは、カレントメタリージョンのコピーを 識別す 
る。 

戻り値 正常終了 T 1 

輿常終了 0 

解脱 GetMetaRgn 関数は、指定され たデバイスコンテキストのカレントメタリージョンを 

取得する。 

関数が正常に終了 した 場合、 —パラ メータはカレントメタリージョンのコピーを 識 
別する。 このコピーの変 吏は、 カレントメタリージョンには 影?？ しない。 

デノくイスコンテキストのカレントクリッビングリージョンは、クリッビングリージョ 
ンとメタリージョンの交点に より定義される。 

参照 - ♦SetMetaRgn 


レントメタリージ 


ンの取得 


GetMetaR 


gdi32.dll 


95 


NT 


GDK V 分 — vjha>4 
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IntersectClipRect 

gdi32.dll 

95 

NT 

指定矩形とクリッピングリージョンから新規クリッピングリージョンの作成 


V C 


V B 


パラメータ 


戻り値 


解脱 

参照 


int IntersectClipRect ( 


HDC 

hdc ， 

// デバイスコンテキストのハンドル 

int 

nLeftRect , 

//矩形の左上隅の X 座標 

int 

nTopRect , 

//雉形の左上隅の y 座標 

int 

nRigliiRec し 

//矩形の右下隅の X 座挖 

int 

nBottomRect 

//妬形のお下隅の y 座榡 


)； 


Declare Function IntersectClipRect Lib " gdi 32" Alias " IntersectClipRect " (ByVal hdc 
As Long , ByVal XI As Long , ByVal Y 1 As Long , ByVal X 2 As Long , ByVal Y 2 As 
Long ) As Long 


•hdc デバイスコンテキストの識別子。 

• nUftReci 妬形の左上隅の論理 x 座技を指定する。 

• nTopReci 矩形の左上隅の論理 y 座標を指定する。 

• nRightRect 矩形の右下隅の論理 x 座標を指定する。 

• nBottomRect 対 i 形の右ド隅の論理 y 座 fj ! を*} fi 定する。 


開数が正'/; V に終了した埸合は、新しいクリッピングリージョンのタイプを示す値を返 
す。戻り値は、以下の値のうち丨つである。 


正常終 f 

新規クリッビングリージョンのタイプを示す値。 

NULLREGION 

リージョンは空。 

SIMPLEREGION 

リージョンは、琳一の矩形である。 

COMFLEXREGION 

リージョンは、枚数の矩形である。 

ERROR 

エラーが発生した（カレントクリッビングリージョンには彩 


響しない)。 


IntersectClipRect 間数は、指定された矩形とカレントクリッビングリージョンの交差 
する部分から、新しいクリッビングリージョンを作成する。 

与えられた矩形の敁も右下隅は、クリッビングリージョンに含まれない。 


— ExcludeClipRect 
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int OffsetClipRgn( 
HDC 


hdc ， // デバイスコンテキストの ハン ドル 

/|从你兄/，/ / x 軸方向のオフセット 
n YOffset // y 軸方向のオフセット 


V B 


パラメータ 


戻り値 


解説 


Declare Function OffsetClipRgn Lib "gdi32" Alias "OffsetClipRgn" (ByVal hdc As 
Long，ByVal x As Long，ByVal y As Long) As Long 

- hdc デバイスコンテキストの識別子。 

• nXOffset 左おに移動する論理単位の数侦を指定する。 

• nYOffset 上ドに移勤する論理単位の数値を指定する。 

1对数が正帘に終 T した坳合は、新しいクリッビングリージョンのタイプを示す値を返 
す。戻り値は、以下の値のうち1つである。 


正常終了 
NULLREGION 
SIMP し EREGION 
COMPLEXREGION 
ERROR 


新規クリッピングリージョンのタイプを示す値 
リージョンは空。 

リージョンは、取一の矩形である。 

リージョンは、抅数の矩形である。 

エラーが発生した（カレントクリッビングリージョンには影 
響しない)。 


OffsetClipRgn 閲数は、デバイスコンテキストのクリッピングリージョンを、指定さ 
れたオフセットだけ移動する。 

—SelectClipRgn 
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クリッビングリージョンの移動 


OffsetCIi 


gdi32.dll 


NT 


95 


2.5 GDI インターフこ 
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PtVisible 

gdi32.dll 

95 

NT 

指定点とクリッビングリージョンの位置関係 


V C 

V B 

パラメータ 


戻り値 


解 

説 

参 

照 


BOOL PtVisible ( 


HDC 

hdc . 

// デバイスコンテキストのハンドル 

int 

nX ， 

//点の X 座標 

int 

nY 

//点の y 座標 


)； 

Declare Function PtVisible Lib " gdi 32" Alias " FtVisible " (ByVal hdc As Long，ByVal x 
As Long , ByVal y As Long ) As Long 

•hdc デバイスコンテキストの識別子。 

• 点の論理 x 座標を指定する。 

- nY 点の論理 y 座標を指定する。 

クリッビングリージョン内に点が位蹬する。 f TRUE 

クリッビングリージョン内に点は位趵しない。 FALSE 

PtVisible 関数は、指定された点がデバイスコンテキストのクリッビングリージョン内 
にあるかどうかを調べる。 


—^RectVisible 


RectVisible 

gdi32.dll 

95 

NT 

矩形領域とクリッピングリージョンの位置関係 


V C BOOL RectVisible ( 

HDC hdc ， // デバイスコンテキストのハンドル 

CONST RECT * Iprc //矩形構造体へのポインタ 

)； 


V B Declare Function RectVisible Lib " gdi 32" Alias " RectVisible " (ByVal hdc As Long ， 

IpRect As RECT ) As Long 


パラメ 

ータ 

•hdc デバイスコンテキストの識別子。 

•Iprc 指定された矩形の論理座標を格納する RECT 構造体へのポインタ。 

戻り 

値 

クリッビングリージョン内に矩形が一部でも含まれる 
クリッビングリージョン内に矩形は含まれない 

TRUE 

FALSE 

解 

説 

RectVisible 関数は、指定された矩形の任怠の部分がデバイスコンテキストのクリッ 
ビングリージョン内にあるかどうかを調べる。 

参 

照 

CreateRectRgn ，— PtVisible ，— RECT ，— SelectClipRgn 
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2.5 <3 DI インターフェイス 


SelectClipPath 

gdi32.dll 

95 

NT 

カレントバスをクリッビングリージョンに選択 


V C 


V B 

パラメータ 


戻り値 


解説 


參 照 


BOOL SelectClipPath ( 

HDC hdc , 

int iMode 

>； 


// デバイスコンテキストのハンドル 
//クリッビングモード 


Declare Function SelectClipPath Lib " gdi 32” Alias M SelectClipPath M (ByVal hdc As 
Long , ByVal iMode As Long ) As Long 

- hdc パスのデバイスコンテキストの識別子。 

- iMode パスの使い方を指定する。以下の値を設定する。 


値 总味 


RGN.AND 

RGN.COPY 

RGN - D 1 FF 

RGN.OR 

RGN XOR 


新しいクリッビングリージョンは、カレントクリッピングリ 
ージョン(遺なる領域)の交点とカレントパスを含む。 

新しいクリッピングリージョンは、カレントパスである。 
新しいクリッビングリージョンは、カレントパスに含まれな 
いカレントのクリッビングリージョンの領域を含む。 

新しいクリッビングリージョンは、カレントのクリッビング 
リージョンの集合(結合された領域)とカレントパスを穴む。 
新しいクリッビングリージョンは、カレントのクリッビング 
リージョンの集合とカレントパスを含む。ただし、希なった 
領域は含まない。 


正常終了 TRUE 

異常終了 FALSE 

詳細なエラー tA •報は、 GetLastErrorliy 数により取得。 GetLastError 閲数は、以卜のエ 
ラーコー ドを返す。 

ERROR 一 CAN _ NOT _ COMPLETE，ERROR 一 INVALID 一 PARAMETER , 
ERROR _ NOT . ENOUGH.MEMORY 

SelectClipPath _ 数は、カレントパスをデバイスコンテキストのクリッビングリージ 
ョンとして进択し、指定されたモードを使用して新しいリージョンを結合する。 

ん也パラメータにより識別されるデバイスコンテキストは、結合するパスを含まなけ 
ればならない。 

BeginPath,EndPath 
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SelectClipRan gdi 32 dii 


ンをカレントクリッビングリージヨンに選択 



NT 


V C int SelectClipRgn ( 

HDC hdc ， // デバイスコンテキストのハンドル 

HRGN hrgn // 迸択されたリージョンのハンドル 

)； 


V b Declare Function SelectClipRgn Lib " gdi 32" Alias ” SelectClipRgn " (ByVal hdc As 

Long , ByVal hRgn As Long ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• hrgn 逸択するリージョンの識別子。 

戻り値 関数が正常に終了した坳舍は、リージョンのタイプを示す値を返す。戻り値は、以 

下の値のうち丨つである。 


NULLREGION 

リージョンは空。 

SIMPLEREGION 

リージョンは、単一の矩形である。 

COMPLEXREGION 

リージョンは、複数の矩形である。 

ERROR 

エラーが発生した(以前のクリッビングリージョンには彩科 
しない)。 


解説 SelectClipRgn I 対数は、リージョンを、指定されたデバイスコンテキストのカレント 

クリッピングリージョンとして逸択する。 

逍択されたリージョンのコピーだけ使用される。リージョン自身は、別のデバイスコ 
ンテキストの任意の番号を遗択され削除される。 

SelectClipRgn 関数は、デバイス啉位で指定されるリージョンの座標を仮定する。 
デバイスコンテキストのクリッビングリージョンを移動するには、 NULL のリージョ 
ンハンドルを指定する。 

參 照 —ExtSelectClipRgn 
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解説 


NULLREGION 

SIMPLEREGION 

COMPLEXREGION 

ERROR 


リージョンは空。 

リージョンは、ポーの 妬形である。 

リージョンは、构数の矩形である。 

ェラーが発生した(以前のクリッビングリージョンには彩博し 
ない )0 


SetMetaRgnl 対数は、カレントメタリージョンとともにデバイスコンテキストを指定 
するカレントクリッビングリージョンを結合し、指定されたデバイスコンテキストの 
ために新しいメタリージョンとして結合されたリージョンを格納する。クリッビング 
リージョンは、 NULL のリージョンとして再設定する。 

デバイス コンテ キストの カレン トクリッビングリージョンは、クリッビングリージョ 
ンとメタリージョンの結合により定義される。 

SetMetaRgnl 対数は、アプリケーションのオリジナルデバイスコンテキストが、 
Sa veDC 関数により格納された後で呼び出される。 

— GetMetaRgn，SaveDC 


201 


V C int SetMetaRgn ( 

HDC hdc // デバイスコンテキストのハンドル 

)； 

V B Declare Function SetMetaRgn Lib M gdi 32" Alias M SetMetaRgn " (ByVal hdc As Long ) 

As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

戻り値 IW 数が正常に終 T した坳合は、新しいクリッピングリージョンのタイプを示す做を返 

す。戻り M は、以下の M のうち丨つである。 


現在のメタリージ- 


ンとクリッピングリージ 


ンから新規のメタリージ 


ンを作成 


SetMetaR 


gdi32.dll 


95 


NT 


2.5 GDI インター フこ 
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Color 


AnimatePalette 


論理バレットエントリの置き換え 


gdi32.dll 



V C BOOL AnimatePalette ( 

HPALETTE hpal , //論理カラーパレットのハンドル 

UINT iStartlndex . //iii 初の綸理ノ、。レットエントリ 

UINT cEntries ， // 論理ノ《レットのエントリ数 

CONST PALETTEENTRY *ppe //Jii 初の;換物へのポインタ 

)； 


V B Declare Function AnimatePalette Lib " gdi 32" Alias " AnimatePaletteA " (ByVal hPalette 

As Long，ByVal wStartlndex As Long , ByVal wNumEntries As Long , IpPaletteColors 
As PALETTEENTRY ) As Long 


パラメ ータ 

• hpal 

• iStartlndex 

• ctLntries 

• ppe 

論理パレットの識別子。 

趵き換える最初の論理パレットのエントリを指定する。 

證き換えるエントリ数を指定する。 

カレントエントリを趵き換えるために使われる PALETTEENTRY 構 
造体の配列の M 初のメンバへのボインタ。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細な エラー 

借報は、〇6〖1^^汀01*閲数により取得 0 


解説 AnimatePalette ^ 数は、指定された綸理パレットのエントリをき換える 0 

アプリケーションは、 GetDeviceCaps 閲数を呼び出し RASTERCAPS 定数を指定する 
ことにより、パレット操作をサボートするデバイスを決めることができる。 
AnimatePalette 閲数は 、 LOGPALETTE 構造体の palPalEntry メンバに PC_RESERVED 
フラグがセットされているときだけエントリを変更できる。 

与えられたパレットがアクティブウィンドウと結合すると、パレットの色はすぐに変 
更される。 

参 照 —Create Palette，—GetDe viceCaps ，— LOGP ALETTE ，— PALETTEENTRY 
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CreateHalftonePalette 

gdi32.dll 

95 

NT 

ハーフトーンバレッ トの作成 





V C 


V B 


パラメータ 
戻り信 


解脱 


参 照 


HPALETTE CreateHalftonePalette ( 

HDC hdc // デバイスコンテキストのハンドル 

)； 


Declare Function CreateHalftonePalette Lib n gdi 32" Alias " CreateHalftonePalette ” 
(ByVal hdc As Long ) As Long 

•hdc デバイスコンテキストの識別子。 

正常終了 1論理ハーフトーンパレットの識別子 
異常終了 0 

詳細なエラー情報は、 GetLastError 関数により取得。 

CreateHalftonePalette 関数は、指定されたデバイスコンテキストのハーフトーンパレ 
ットを作成する。 

アプリケーシヨンが、デバイスコンテキストの伸縮モードに HALFTONE を設定する 
ことにより、ハーフトーンパレットを作成する。 StretchBlt 関数や StretchDIBits 閲数 
が呼び出される前に、 CreateHalftonePalette 閲数により取得した論理ハーフトーンパ 
レットを、デバイスコンテキストより選択し実現させる。 

必要なくなったパレットは、 DeleteObject 関数により削除する。 

DeleteObject ，— RealizePalette ，— SelectPalette ，— SetStretchBItMode ，— StretchDIBits ， 

—StretchBlt 
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CreatePalette 

gdi32.dll 

95 

NT 

論理カラーバレ ッ トの作成 | 


V C 

V B 

パラメータ 

戻り値 

解説 

参 照 


HPALETTE CreatePalette ( 

CONST LOGPALETTE *lplgpl // 論理カラーパレットへのポインタ 
)； 

Declare Function CreatePalette Lib M gdi 32" Alias ’ CreatePalette " (lpLogPalette As 
LOGPALETTE ) As Long 

• Iplgpl 論理カラーパレット内の.色に関する怡報を格納する、 LOGPALETTE 構 

造体へのボインタ。 

正常終了 論理ハーフトーンパレットのハンドル 

與帘終了 NULL 

詳細なエラー怡報は、 GetLastErrorl 划数により取得 0 
CreatePalette 関数は、論理カラーパレットを作成する。 

アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 
アプリケーションは論理パレットを作成すると、 SelectPalette 関数を呼び出すことに 
よりデバイスコンテキストのパレットを迸択することができる。デバイスコンテキス 
卜より进択されたパレットは、 RealizePalette 関数を呼び出すことにより実現化され 
る。 

必要なくなったパレットは、 DeleteObject 関数により削除する 0 
DeleteObject ，— GetDeviceCaps ，— LOGPALETTE ，— RealizePalette ，— SelectPalette 
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2.5 GDI インターフェイス 


GetColorAdjustment 

gdi32.dll 

■ 

NT 

カラー 値の取得 


V C 


V B 


パラメータ 


戻り値 


解説 


BOOL GetCoIorAdjustment 

HDC hdc ， 

LPCOLORADJUSTMENT Ipca 

)； 


// デバイスコンテキストのハンドル 

// COLORADJUSTMENT 構造体へのポインタ 


Declare Function GetColorAdjustment Lib " gdi 32" Alias " GetColorAdjustment " (ByVal 
hdc As Long，lpca As COLORADJUSTMENT ) As Long 

• hdc デバイスコンテキストの識別子。 

• lpca 色を調幣した侦を受け取る COLORADJUSTMENT 構造体へのボインタ。 


正常終了 
輿常終了 


TRUE 

FALSE 


詳細なエラー怡報は、 GetLastErroi ■関数により取得。 

GetColorAdjustment 関数は、指定されたデバイスコンテキストに調整されたカラー値 
を取得する。 


参 照 


SetColorAdiustment，—COLORADJUSTMENT 
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GetNearestuolor Lg di32dl1 [ 95 l_ NT 

表示可能なシステムカラー値取得_ 

V C COLORREF GetNearestColor ( 

HDC hdc ， //デバイスコンテキストのハンドル 

COLORREF crColor //識別させる色 

)； 

V B Declare Function GetNearestCoIor Lib ” gdi 32" Alias " GetNearestColor " (ByVal hdc As 

Long，ByVal crColor As Long ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• crColor 識別させる色の値を指定する。 

戻り値 

詳細なエラー情報は、 GetLastError 関数により取得。 

解脱 GetNearestColor 関数は、指定された色により近い色をシステムパレットから取得する。 

参照 — GetDe viceCaps ，— GetNearestPalettelndex，—COLORREF 
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2.5 GDI インターフェイス 


GetNearestPalettelndex 

gdi32.dll 

95 

NT 

論理パレットエントリのインデックス取得 


V C UINT GetNearestPaletteIndex ( 

HPALETTE hpal , //論理カラーパレ ッ トのハンドル 

COLORREF crColor //識別させる色 

)； 


V B Declare Function GetNearestPalettelndex Lib " gdi 32" Alias " GetNearestPaletteIndex M 

(ByVal hPalette As Long , ByVal crColor As Long ) As Long 


パラメータ 

• hpal 1 

• cnolor i 

益理 カラーパレットの 識別子。 

識別させる色を指定する。 

戻り 値 

正常終了 

異常終了 

論理パレットエントリのインデックス 

CLR INVALID 


詳細なエラー怡報は、 GetLastError 関数により取得。 

解説 GetNearestPalettelndex 関数は、指定されたカラー値に一番近い色の論理パレットエ 

ントリのインデックスを取得する。 

アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 
与えられた論理パレットに PC _ EXPLICIT フラグが設定されたエントリが含まれた坳 
合の戻り値は、不確定である。 

•照 — GetDeviceCaps ，— GetNearestColor ，— GetPaletteEntries ，— GetSystemPaletteEntries ， 

—COLORREF 
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GetPalettetmries 」 gdi 32 d" [ 95 | nt 

バレットエントリ範囲の取得 

V C VCUINT GetPaletteEntries ( 

HPALETTE hpal ， //論理 カラー パレ ッ トのハンドル 

UINT iStartlndex . //敁初に取得するエントリ 

UINT nEntries ， //取得するエントリの数 

LPPALETTEENTRY Ippe //エントリ取以用の配列のアドレス 

)； 

V B Declare Function GetFaletteEntries Lib ” gdi 32" Alias " GetPaletteEntries " (ByVal 

hPalette As Long , ByVal wStartlndex As Long , ByVal wNumEntries As Long , 
IpPaletteEntries As PALETTEENTRY ) As Long 

パラメータ • hpal 論理 カラーパレットの 識別子。 

• iStartlndex Jii 初に取得する論理パレットのエントリを指定する。 

• nEntries 取得する論理パレットのエントリ数を指定する。 

- Ippe パレットエントリを受け取る PALETTEENTRY 構造体の fill 列へのポ 

インタ。この配列は、•打パラメータで指定された数以上の桃造 
体を保持していなくてはならない。 

戻り値 正常終了 爾^ットハンドル手 NULL |取得したエントリ数 

正常終了論理パレットハンドル =NULL 与えられたパレット内のエントリ数 

輿常終了 0 

詳細なエラー怡報は、 GetLastError 関数により取得。 

解 説 GetPaletteEntries 閲数は、与えられた論理パレットから指定されたパレットエントリ 

の範_を取得する。 

アプリケーションは、 GetDeviceCaps 閲数を呼び出し、 RASTERCAPS 定数を指定す 
ることにより パレ ット操作をサボートするデバイスを決めることができる。 

Ai £ mr / 打パラメータがパレ ット内に存在する エン トリ以上の数を指定した坳合、 
PALETTEENTRY 構造体の残りの费索は変更されない。 

^ m — GetDeviceCaps ，— GetSystemPaletteEntries ，— PALETTEENTRY 
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GetSystemPaletteEntries 

gdi32.dll 

95 

NT 

システムバレットからバレットエントリ範囲を取得 


V C UINT GetSystemPaletteEntries ( 

HDC hdc , // デバイスコンテキストのハンドル 

UINT iStarthuiex ， //取得する M 初のエントリのインデックス 

UINT nEntries , //取得するエントリ数 

LPPALETTEENTRY Ippe //システムパレットエントリを取得する配列 

)； 


V B Declare Function GetSystemPaletteEntries Lib M gdi 32" Alias "GctSystemPalette 

Entries"(ByVal hdc As Long , ByVal wStartlndex As Long , ByVal wNumEntries As 
Long，lpPaletteEntries As PALETTEENTRY ) As Long 


パラメータ 

•hdc 

デバイスコンテキストの識別子。 


• iStartlndex 

システムパレットから取得された敁初のエントリを指定する。 


• nEntries 

システムパレ ットより取得する エン トリ数を指定する0 


• Ippe 

パレットエントリを受け取る、 PALETTEENTRY 構造体の配列への 
ポインタ。配列は、少なくとも•打パラメータに指定したエント 
リ数以上の構造体驳索がなければならない。このパラメータが NULL 
の場合、この関数はパレットのエントリ総数を返す。 

戻り値 

正常終了 

取得したエントリ数 


興常終了 

0 


•細なエラー trt 報は、 GetLastErrorlJy 数により取得。 

解説 GetSystemPaletteEntries 関数は、衍定されたデバイスコンテキストに|划述するパレッ 

ト エン ト リの 範囲を システムパレ ットから取得する。 

アプリケーションは、 GetDeviceCaps 閲数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 

参照 — GetDeviceCaps ，— GetPaletteEntries ，— PALETTEENTRY 


GDIAV 必 17 ha>4 
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GetSystemPaletteUse 

gdi32.dll 

95 

NT 

システム（論理）バレットの現在の状態を取得 


V C 


V B 


パラメータ 
戻り値 


解脱 


参 照 


UINT GetSystemPaletteUse ( 

HOC hdc //デバイスコンテキストのハンドル 

)； 

Declare Function GetSvstemPaletteUse Lib ” gdi 32” Alias " GetSystemPaletteUse " 
(ByVal hdc As Long ) As Long 

•hdc デバイスコンテキストの識別子。 

関数が正常に終了した埸合、システムパレットの現在の状態を返す。以下の値のい 


ずれかになる。 


値 

意味 

SYSPAL.NOSTATIC 

システムパレットには、黒と白以外のスタテイックカラーが 
ない0 

SYSPA し STATIC 

システムパレットには、アプリケーションが論理パレットを 
実体化したときにも変更されないスタティックカラーが含ま 
れている。 

SYSPAL.ERROR 

与えられたデバイスコンテキストが不正であるか、カラーパ 
レットをサポートしない。 


詳細なエラー怡報は、 GetLastError 関数により取得。 

GetSystemPaletteUse 閲数は、指定されたデバイスコンテキストのシステム(論理)パレ 
ットの現在の状態を取得する。 

システムパレットには、20個のデフオルトのスタティックカラーが含まれている。こ 
れらの色は、アプリケーションが論理パレットを実体化しても変更されない。アプリ 
ケーションは SetSystemPaletteUse 関数を呼び出して、これらの色のほとんどにアクセ 
スできる。 

hdc パレッ トにより識別するデバイスコンテキストは、カラーパレットをサポートす 
るデバイスを表さなければならない。 

アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 


GetDeviceCaps,SetSvstemFaletteUse 
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RealizePalette 

gdi32.dll 

95 

NT 

バレットエントリの割り当て 


V C 


UINT RealizePaIette ( 

HOC hdc 


// デバイスコンテキストのハンドル 


V B 


パラメータ 
戻り僅 


解脱 


Declare Function RealizePalette Lib M gdi 32 f, Alias " RealizePalette ” (ByVal hdc As 
Long ) As Long 

•hdc 迸択された論理パレットを含むデバイスコンテキスト ( DC ) の識別子。 


正常終了 
興常終了 


システムパレットに； 1 } U り当てられる論理パレットエントリ数 

GDI ERROR 


詳細なエラー怡報は、 GetLastEnw 開数により取得。 

RealizePalette 関数は、パレットエントリを、カレント論理パレットからシステ厶パレ 
、、) 卜に割り当てる。 

アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 
RealizePalette 関数は、指定されたデバイスコンテキストに阒迚するデバイスのパレッ 
卜を変更する。デバイスコンテキストがメモリであった場合、デバイスコンテキスト 
から透択されたビットマップのカラーテーブルが変更される。デバイスコンテキスト 
がディスプレイであった場合、デバイスの論理パレットが変更される。 

•論理カラーパレットは、色彩の表現を重視するアプリケーションとシステムとの問 
で、バッファとして動作する。アプリケーションはこのパレットを使用して、独自に 
表示する色やほかのウィンドウに表示される色に影??を与えることなく、必要なだけ 
の色数を使用することができる。 

アプリケーションのウィンドウがフォーカスを持つときに RealizePalette 阅数を呼び出 
すと、 Windows は、要求した可能な限りすベての色を表示できるようにする。同じ 
ことが、非アクティブウィンドウについても当てはまる。 


参 照 


CreatePalette ， GetDeviceCaps，SelectPalette 


丨 一 
GDIAV 公 — 7ha>4 | 
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ResizePalette 

gdi32.dll 

95 

NT 

論理バレットサイズの拡大縮小 


V C BOOL ResizePalette ( 

HPALETTE hpal 、 "論理ノ 、。レ ットのハンドル 

UINT nEntries //論理ノ《レットのパレットエントリ数 

)； 


V B Declare Function ResizeFalette Lib " gdi 32" Alias " ResizePalette " (ByVal hPalette As 

Long , ByVal nNumEntries As Long ) As Long 


パラメータ 

• hpal 

• nuitries 

変史するパレットの識別子。 

サイズ変更後のパレット内のエントリ数を指定する。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー 

M •報は、 GetLastErrorliy 数により取得。 


解説 ResizePalettelftl 数は、指定された値に基づいた論理パレットのサイズを拡大、縮小す 

る。 

アプリケーションは、 GetDeviceCaps 閲数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 

アプリケーションで ResizePalette 閲数を呼び出してパレットのサイズを縮小するとき、 
サイズ変史されたパレット内に残っているエントリは変更されない。 ResizePalette I 对 
数を呼び出してパレットを拡大するときには、追加されるパレットエントリは黒に設 
定され(赤、緑、青の値はすべて0>、それらのフラグが0に設定される。 

参照 GetDeviceCaps 
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SelectPalette 

gdi32.dll 

95 

NT 

論理パレットの選択 


V C 


V B 


パラメータ 


戻り値 


解説 


HPALETTE SelectPalette( 

HDC hdc ， // デバイスコンテキストのハンドル 

HPALETTE hpal , //論理カラーパレットのハンドル 

BOOL bForceBackground //前；;！:/背獄モード 

)； 

Declare Function SelectPalette Lib "gdi32" Alias "SelectPalette" (ByVal hdc As Long ， 
ByVal hPalette As Long, ByVal bForceBackground As Long) As Long 


hdc 

hpal 

bForceBackground 


デバイスコンテキストの識別子。 

遠択する論理パレットの識別子。 

論理パレットを常に竹贵パレットにするかどうかを指定す 
る。この W が TRUE のとき、この I 划数は可能な限り物理パレ 
、、) 卜内の色を論理パレットに設定する。実体化されたパレッ 
卜を持つウィンドウがフォーカスを持たないスレッドにし 
ているときには、これが実行されている。 

この値が FALSE で、 アプリケー ショ ンが前而にあるとき、 
RealizePalette 間数が論理 パレ ッ トをデバイスパレ ッ トにコピ 
一させる （ /i み，パラメータがメモリデバイスコンテキストで 
あるとき、この パラメータは 無祝される>。 


正常終了 

異常終了 


以前の,論理 ノ、。レット の識別子 
NUL し 


，ぼ細なエラ ー 怡報は、 GetLastError 閲数により取得。 

SelectPalette 関数は、デバイスコンテキストに、指定された論理パレットを選択する。 
アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 
アプリケーションは、构数のデバイスコンテキストに同じ I 論理パレットを選択でき 
る。しかし、綸理パレットを変史‘した場合、すべてのデバイスコンテキストに逸択さ 
れているパレットに影矜を与える。トップ レベルの ウィンドウの子ウィンドウがそれ 
ぞれ自分のノ《レットを実体化した場合、アプリケーションは、 bForceBackground パ 
ラメータに TRUE を設定して SelectPalette_ 数を呼び出す。しかし、パレットを実体 
化する必要のある子ウィンドウだけに、⑽パラメータに TRUE を設定 
しなければならない。他の子ウィンドウには、 FALSE を設定する。 


参 照 


CreateFalette,GetDeviceCaps,RealizePalette 


GDIA V 必 17 ha>4 
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SetColorAdjustment 

gdi32.dll 

95 

NT 

デバイスコ 

|ンテキストへのカラー値設定 1 


V C 


BOOL SetColorAdjustment ( 

HDC hdc % 

CONST COLORADJUSTMENT * Ipca 

)； 


// デバイスコンテキストのハンドル 

//COLORADJUSTMENT 構造体 
へのポインタ 


V B Declare Function SetColorAdjustment Lib " gdi 32 M Alias " SetColorAdjustment " (ByVal 

hdc As Long，lpca As COLORADJUSTMENT ) As Long 


パラメ-夕 .hdc デバイスコンテキストの識別子。 

• Ipca 調幣した色の値を格納する COLORADJUSTMENT 構造体へのボインタ。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


詳細なエラー怡報は、 GetLastError 関数により取得。 

解脱 SetColorAdjustment 閲数は、指定されたを使用するデバイスコンテキストに合った 

色を設定する。 

合わせた色は、 HALFTONE モードを設定されたときに、 StretchBlt 関数や 
StretchDIBits 関数を呼び出すためにソースビットマップの入力色を合わせるのに使わ 
れる。 

^ 照 COLORADJUSTMENT , SetStretchBltMode , StretchBlt,StretchDIBits 
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SetPaletteEntries _ 」 gdi 32 d" L 95 | nt 

RGB 値とフラグの設定 _ 

V C UINT SetPaletteEntries ( 

HFALETTE hpal , // 論理ノ、。レットのハンドル 

UINT iStart , //設定する hi 初の エントリのインデックス 

UINT cEntries ， //設定するエントリの数 

CONST PALETTEENTRY */ p ^ //構造体の配列のアドレス 

)； 

V B Declare Function SetPaletteEntries Lib " gdi 32" Alias " SetPaletteEntries " (ByVal 

hPalette As Long , ByVal wStarllndex As Long , ByVal wNumEntries As Long , 
IpPaletteEntries As PALETTEENTRY ) As Long 

パラメータ • hpal 論理•パレットの識別子 0 

• iStart 設定する論理パレット内の域初のエントリを指定する。 

• cEntries 設定する論理パレット内のエントリ数を指定する。 

• Ippe RGB 値とフラグを格納する PALETTEENTRY 構造体の配列の M 初の赀 

索へのポインタ。 

戻り 値 正常終了 |"設定^ I たエン 

異常終了 0 

詳細なエラー怡報は、 GetLastErrorl 划数により取得。 

解説 SetPaletteEntries 関数は、論理パレットの範囲内のエントリに、 RGB (赤、緑、青)力 

ラー値とフラグを設定する。 

アプリケーションは、 GetDeviceCaps 閲数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 

論理パレットがデバイスの中に迸択され実体化されていると、パレットの変史は表面 
上、論理パレットに影湃しない。新しい論理パレットを設定するためには、 
RealizePalette 閲数を呼び出さなければならない。 

参 m GetDeviceCaps , RealizePalette,PALETTEENTRY 
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SetSvstemPaletteUse gdi 32 dii 


95 NT 



ックカラーの 使用 


V c UINT SetSystemPaletteUse ( 

HDC hdc ， // デバイスコンテキストのハンドル 

UINT uUsage // ノ、。レット使用フラグ 

)； 

V B Declare Function SetSystemPaletteUse Lib " gdi 32" Alias " SetSystemPaletteUse ” (ByVal 

hdc As Long , ByVal wUsage As Long ) As Long 

パラメータ .hdc デバイスコンテキストの 識別子 0 このデバイスコンテキストは、カラー 

パレットをサポートしなければならない。 

- uUsage システムパレットの新しい使い方を指定する。このパラメータは、以 

下の値のいずれかになる。 

_ "[意味 _ 

SYSPAL.NOSTATIC システムパレットは 2 補のスタティックカラー(白と黒)を含 

む。 

SYSPAL.STATIC システムパレットには、論理パレットが実体化されても変更 

されない スタティックカラーが 含まれる。 

戻り値 正常終了 システムパレッ トの以前の設定 

( SYSPAL - NOSTATIC，SYSPAL 一 STATIC のいずれか） 

異常終了 SYSPAL_ERROR 

詳細なエラー怡報は、 GetLastEnor 関数により取得。 

解説 SetSystemPaletteUse 関数は、アプリケーションにシステムパレット内の2または20の 

スタティックカラーの利用を許可する。デフオルトのシステムパレットは20のスタテ 
ィックカラーが 含まれて いる（スタティックカラーはアプリケーションが 論理 パレット 
を実体化しても変更されない)。 

アプリケーションは、 GetDeviceCaps _ 数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 

アプリケーションウィンドウが、前面に移勁し SYSPAL _ NOSTATIC 値が,役定されて 
いた埸合、アプリケーションは設定されているカレントシステムカラーを保存するた 
め GetSysColorlW 数を呼び出さなければならない。黒と白のみを使用可能と設定する 
ためには、 SetSysColors 関数を呼び出す。アプリケーションが背後に戻るか終了した 
とき、前のシステムカラーを回復しなければならない。 
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閲数が SYSPAL _ ERROR を返した坳合は、指定されたデバイスコンテキストが不正 
であるか、カラーパレットがサポートされていない。 

アプリケーションは、ウィンドウが敁大化されていて入カフォーカスを持っていると 
きだけ、この関数を呼び出さなければならない。 

uUsage パラメータに SYSPAL.NOSTATIC を設定して SetSystemPaletteUse I 対数を呼 
び出した場合、 Windows はシステムパレットの2つのエントリのうち白と黒のエント 
リだけを残す。 

tiUsuge パラ メータに SYSPAL _ NOSTATlC を,没定してこの_数を呼び出した坳合は、 
アプリケーションは以下の作業を実行しなければならない。 

1) 論理パレットを実体化する。 

2) GetSysColor 関数を呼び出して、カレントシステムカラーの•没定を保存する 0 

3) SetSysColors 開数を呼び出し、黒と白を使用してシステムカラーを適切な値 
に設定する。たとえば、隣り合う項目や敏なり合う項目（ウィンドウの枠と境 
界など)は、それぞれ黒と白とに色分けして設定する。 

4) ほかのトップ レベル ウインドウに WM_SYSCOLORCHANGE メッセージを 
送って、それらが新しいシステムカラーを使用して洱描画できるようにする。 

アプリケーションのウィンドウがフォーカスを失うかクローズした埸合には、 
アプリケーションは以下の作業を実行しなければならない。 

1) uUsage パラ メータに SYSPAL_STATIC を設定して 、 SetSystemPaletteUse I 知 
数を呼び出す。 

2) 論理パレットを実体化する。 

3) システムカラーを元の値に復元する。 

4) WM__SYSCOLORCHANGE メッセージを送る0 

參照 GetDeviceCaps , GetSysColor,SetSysColors 


GDI AV 分 — 7ha >4 
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UnrealizeObject 

gdi32.dll 

95 

NT 

論理バレットのリセット 


V C BOOL UnrealizeObject ( 

HGDIOBJ hgdiobj // 論理ノ 、。レットの ハンドル 

)； 


V B Declare Function UnrealizeObject Lib M gdi 32" Alias " UnrealizeObject " (ByVal hObject 

As Long ) As Long 


パラメータ 

• hgdiobj 

リセットする論理パレットの識別子。 

戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


詳細なェラー怡報は、 GetLastError 関数により取得。 

解脱 UnrealizeObject 閲数は、 • 論理パレットをリセットする 0 この I 対数は、初期状態で実 

体化するようにシステムに指示する。その後、アプリケーションが指定されたパレッ 
卜に対して RealizePalette 関数を呼び出すと、システムは論理パレットをシステムパ 
レットに完全に割り当て直す。 

hgdiobj がブラシであった垛合、 UnrealizeObject 関数は何もせずに TRUE を返す。ブ 
ラシの原点を設定するときは、 SetBrushOrgEx 関数を使う。 

UnrealizeObject 関数は、ストックオブジェクトに対しては使わない 0 迫うパターンが 
GetStockObject ( DEFAULT _ PALETTE ) を呼び出し取得されたら、それはストックオ 
ブジェクトである。 

/ I 取//〇がパラメータに識別されるパレ ッ トには、デバイスコンテキストに現在进択さ 
れているパレットを設定できる。 

参 照 GetStockObject ， RealizePalette，SetBrushOrgEx 
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UpdateColors 

gdi32.dll 

95 

NT 

クライアント領域の更新 


V C BOOL UpdateColors ( 

HDC hdc // デバイスコンテキストのハンドル 

)； 

V B Declare Function UpdateColors Lib " gdi 32 M Alias " UpdateColors " (ByVal hdc As Long ) 

As Long 


パラメータ .hdc デバイスコンテキストの識別子。 


戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


細なエラー怡報は、 GetLastError 関数により取 

解説 UpdateColors I 対数は、クライアント領域のカレントカラーを実体化された論理パレッ 

卜に再榊成することにより、指定されたデバイスコンテキストのクライアント領域を 
史新する。 

アプリケーションは、 GetDeviceCaps 関数を呼び出し、 RASTERCAPS 定数を指定す 
ることによりパレット操作をサボートするデバイスを決めることができる。 
実体化された綸珲パレットを持つ非アクティブウィンドウは、システムパレットを変 
更するときに、クライアント領域を再描刚する代わりに UpdateColors を呼び出して領 
域を更新できる。 

通常は、クライアント領域を再描画するよりも UpdateColors 関数を使用した方がす 
ばやく領域を史新する。しかし、 UpdateColors [対数ではシステムパレットが変更され 
る前の各ピクセルの色に基づ t ゝて色を変史するため、色の正確さが拟なわれることが 
ある。 

この関数は、 WM_PALETTECHANGED メッセージ取得後すぐに呼び出さなければ 
ならない。 

^ ^ GetDeviceCaps，RealizePalette 
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1 Coordinate Space and 1 ranstormation 

画 

ClientToScreen 

user32.dll 

95 

NT 

クライアント座標をスクリーン座標に変換 


V C 


V B 

パラメータ 


戻り値 


解脱 


参 照 


BOOL ClientToScreen ( 

HWND hWnd . // 変換元座標のウィンドウハンドル 

LPPOINT IpPoint //スクリーン座標の構造体へのポインタ 

)； 

Declare Function ClientToScreen Lib M user 32" Alias " ClientToScreen '' (ByVal hwnd As 
Long，IpPoint As POINTAPI ) As Long 

• hWnd 変換されるために使われるクライアント領域を持つウィンドウの識別子。 

• IpPoint 変換されるクライアント座標を格納している、 POINT 構造体へのポイン 

夕。新しいスクリーン座技は、この閲数が正常に終了したときにこの祸 
造体に コピー される。 

正常終了 TRUE 

異常終了 FALSE 

ClientToScreen 関数は、指定された点のクライアント座標をスクリーン座標に変換す 
る。 

ClientToScreen I 対数は、 POINT 構造体のクライアント座標をスクリーン座標に!き換 
える。スクリーン座標は、画面の左上隅からの相対座控である。 


MapWindowPoints , POINT,ScreenToClient 
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CombineTransform 

gdi32.dll 


NT 

ページ空間への変換 


V C 


V B 


パラメータ 


戻り値 


解説 


BOOL CombineTransform ( 

LPXFORM IpxfomtResult 、 // 変換結果へのポインタ 

CONST XFORM ^IpxformL // 敁初の変換ポインタ 

CONST XFORM ^ lpxform 2 111 番 H の変換ポインタ 

)； 

Declare Function CombineTransform Lib M gdi 32” Alias M CombineTransform M 
(lpxformResult As xform，lpxforml As xform , lpxform 2 As xform ) As Long 

- lpxformResult 変換結果を取得する XFORM 構造体へのポインタ。 

• lpxforml 敁初の変換を識別する XFORM 構造体へのボインタ。 

• lpxforml 2番目の変換を,裁別する XFORM 構造体へのポインタ 


正常終了 

異常終了 


TRUE 

FALSE 


CombineTransform 関数は、 2 WORD 空問からページ空問に変換する。 W 初の変換と 
2番目の変換は同じ影?？を受ける。 

3つの変換が必©とされるのは珍しくない。 たとえば lpxforml は、 XFORM 構造体を 
lpxf () rmRes " lt と1“] じように指すことができる。 


参 照 


GetWorldTransform ， ModifyWorldTransform ， SetWorldTransfomi，XFORM 


GDIA V 公 —7 HAy4 
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DPtoLP 

gdi32.dll 

95 

NT 




バイス座標を論理座標に変換 


v c BOOL DPtoLP ( 

HDC hdc . // デバイスコンテキストの ハン ドル 

LPPOINT IpPoints ， //座標の配列へのポインタ 
int nCount //座標の数 

)； 


V B Declare Function DPtoLP Lib ” gdi 32 M Alias ,, DPtoLP M (ByVal hdc As Long，IpPoint As 

POINTAP 1 ，ByVal nCount As Long ) As Long 


パラメータ 

• hdc 

デバイスコンテキストの識別子。 


• IpPoints 

POINT 構造体の fid 列へのボインタ。各 POINT 構造体の x ， y 座標が変 
換される。 


# nCount 

K 列中の座標の数を指定する。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


解説 DPtoLP 間数は、デバイス座標を論理座標に変換する 0 変換後の座標は、デバイスコ 

ンテキストのマツビングモード、デバイスのウインドウとビューポートのそれぞれの 
原点と大きさの設定そしてワールド変換により決まる。 

DPtoLP |» 数は、デバイス座標が27ビットを超えたときや変換した論理座標が32ビッ 
卜を超えたとき失敗する。オーバーフローの埸合、すべてへのポインタは不確定であ 
る。 

^ 照 LPtoDP，POINT 
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2.5 GDI インターフェイス 


V C 


V B 


✓マラメータ 


戻り a 


解説 
参照 


BOOL GetCurrentPositionEx ( 
HDC hdc ， 

LPPOINT IpPoint 

)； 


// デバイスコンテキストのハンドル 

//カレント位置を取得する構造体アドレス 


Declare Function GetCurrentPositionEx Lib " gdi 32" Alias " GetCurrentPositionEx ' 
(ByVal hdc As Long，IpPoint As POINTAPI ) As Long 


• hdc 

• IpPoint 


デバイスコンテキストの識別子。 

カレント位 [ fi の座標を取得する POINT 構造体へのポインタ 


正常終了 
興常終了 


TRUE 

FALSE 


GetCurrentPositionEx 閲数は、カレント位を論理座標で取得する 0 


MoveToEx,POINT 


V C 


V B 


ノ ゞ ラメータ 


int GetDeviceCaps ( 
HDC 
int 

)； 


hdc ， // デバイスコンテキストを識別するハンドル 

nIndex //取份す る M •報の タイプ 


Declare Function GetDeviceCaps Lib " gdi 32" Alias " GetDeviceCaps M (ByVal hdc As 
Long，ByVal nlndex As Long ) As Long 

•hdc デバイスコンテキス トを識別する ハンドルを 指定する。 

• nlndex 取得する怡報のタイプを指定する。指定する値は次のいずれかとなる。 



意味 

DRIVERVERSION 

デバイスドライバのバージョン 番号 

TECHNOLOGY 

デバイス神別。後述の 「♦ TECNOROGY の値」を参照。 

HORZSIZE 

物押•ディスプレイの幅 （ ミリメートル単位） 

VERTS 1 ZE 

物理ディスプレイのぬ•さ（ミリメートル琳位 

HORZRES 

ディスプレイの輻(ビクセル琳位> 

VERTRES 

ディスブレイの高さ（ラスター行啉位） 

LOGPIXELSX 

ディスプレイの幅の論理インチ当たりのビクセル数 


GetDeviceCaps 

gdi32.dll 

95 

NT 

ディスプレイデバイスの固有情報を取得 


GetCurrentPositionEx 

gdi32.dll 

95 

NT 

デバイスコンテキストのカレント論理座標の取得 


GDIAV 必 17 h-\>4 
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LOGPIXELSY 

BITSPIXEL 

PLANES 

NUMBRUSHES 

NUMPENS 

NUMMARKERS 

NUMFONTS 

NUMCOLORS 

ASPECTX 

ASPECTY 

ASPECTXY 

PDEVICESIZE 

CLIPCAPS 

RASTERCAPS 

RC _ GDI 20 一 STATE 
RC.NONE 

RC _ OP _ DX_OUTPUT 
RC 一 PALETTE 
RC.SAVEBITMAP 
RC 一 SCALING 
RC 一 STRETCHBLT 
RC.STRETCHDIB 
CURVECAPS 

LINECAPS 

POLYGONALCAPS 

TEXTCAPS 


ディスブレイの萵さの論理インチ当たりのピクセル数 
各ピクセルの隣接したカラービットの数 
カラーブレーンの数 
デバイス固有のブラシの数 
デバイス固有のペンの数 
デバイス阇有のマーカーの数 
デバイス固有のフォントの数 
デバイスのカラーテーブル内のエントリ数 
線の描_に使うデバイスピクセルの相対幅 
線の描幽に使うデバイスピクセルの相対岛さ 
線の描 W に使うデバイスピクセルの対角紛の幅 
PDEVICE 内部構造体のサイズ(バイト啉位） 

デバイスがサポートするクリッピング能力。後述の 
「籲 CLIPCAPS の姐」を参照。 

デバイスがサポートするラスター能力。後述の 
「• RASTERSCAPS の値」を参照。 

デバイスコンテキスト内に状態ブロックを含む 

ラスター 演?):をサポートしない 

非透過デバイスと DXW 列をサポート 

パレッ ト ベースの デバイスを指定 

ビットマップをローカルに 保存 

スケーリングをサポート 

StretchBlt 関数をサポート 

StretchDIBhs 関数をサポート 

デバイスがサポートする曲線描 W 能力。後述の 
「籲 CURVECAPS のを参照。 

デバイスがサポートする線分描_能力。 

後述の「• LINECAPS の W 」 を参照。 

デバイスがサポートする多角形描幽能力。後述の 
「• POLYGONALCAPS の値」を参照。 

デバイスがサボートするテキストの表示能力。後述の 
「• TEXTCAPS の値」を参照。 
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値 

总味 

CP.NONE 

出力はクリップされません。 

CP_RECTANGLE 

出力は長方形にクリップされます。 

CP-REGION 

出力はリージョンにクリップされます。 

SIZEPALETTE 

システムパレット内のエントリ数。このインデ 
ックスは、デバイスドライバが RASTERCAPS 
インデックスに RC_PALETTE ビットをセットし 
ているときだけ有効で、 Windows3.0 以降に対応 
するドライバだけが使用できる。 

NUMRESERVED 

システムパレット内のチ約エントリ数。このイ 
ンデックスは、デバイスドライバが 
RASTERCAPS インデックスに RC_ 
PALETTE ビットをセットしているときだけも•効 
で、 Windows3.0 以降に対応するドライバだけが 
使用できる。 

COLORRES 

デバイスのカラー解像度 （ ピクセル当たりのビッ 
卜数〉。デバイスドライバが RASTERCAPS イン 
デックスに RC_PALETTE ビットをセットしてい 
るときだけ釘効で、 Windows3.0 以降に対応す 
るドライバだけが使用できる。 


❹ TECHNOLOGY の値 

TECHNOLOGY (デバイス補別）は、次の W のいずれか。 


値 

意味 

DT.PLOTTER 

ベクタープロッタ 

DT.RASDISPLAY 

ラスターディスプレイ 

DT.RASPRINTER 

ラスター プリ ンタ 

DT.RASCAMERA 

ラスターカメラ 

DT.CHARSTREAM 

文字 ストリーム 

DT.METAFILE 

メタファイル 

DT DISPFILE 

ディスプレイファイル 


春 CLIPCAPS の値 

CLIPCAPS (デバイスがサポートするクリッピング能力）は、次の趴のいずれか. 


GDIAV 必 17 ha>4 
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• RASTERCAPS の値 

RASTERCAPS (デバイスがサポートするラスター能力）は、次の fii 1 (の組み介わせ。 



愈味 

RC.BANDING 

バンド処理をサポート 

RC 一 BIGFONT 

64 KB より大きいフォントをサポート 

RC.BITBLT 

ビットマップを転送 

RC 一 BITMAP 64 

64 KB より大きいビットマップをサポート 

RC 一 DEVBITS 

デバイスビットマップをサポート 

RC 一 DI 一 BITMAP 

SetDIBits 関数と GetDIBits 閲数をサポート 

RCLDIBTODEV 

SetDIBUsToDevicelW 数をサポート 

RC_F し00 DFIL し 

衆りつぶしを灾行 

RC 一 GDI 20 _OUTPUT 

Windows 2.0 機能をサポート 


• CURVECAPS の値 

CURVECAPS (デバイスがサポートする曲線描 N 能力）は、次の(の糾み合わせ。 



总味 

CC . N 0 NE 

曲線をサポートしない 

CC 一 CIRCLES 

in をサポート 

CC—PIE 

m 形をサポート 

CC . CH 0 RD 

弓形をサボート 

CC.ELLIPSES 

格円をサポート 

CCLWIDE 

幅のある境界をサポート 

CC.STYLED 

スタイルを持つ境界をサポート 

CC.WIDESTYLED 

スタイルを持ち、幅のある境界をサポート 

CCJNTERIORS 

内部の後りつぶしをサポート 

CC.ROUNDRECT 

丸い角を持つ鉍方形をサポート 
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Vi . 

总味 

PC.NONE 

多 ft 形をサポートしない 

PC_POLYGON 

交 ff モードでの多灼形の涂りつぶし 


をサポート 

PC_RECTANGLE 

及ノ/形をサポート 

PC.WINDPOLYGON 

卞域モードでの多灼形の•中りつぶしをサポート 

PC 一 SCANUNE 

/ t •作線の描_をサポート 

PC.WIDE 

幅のある境界をサポート 

PC.STYLED 

スタイルを持つ堍界をサポート 

PC.WIDESTYLED 

スタイルを行ち.幅のある悅界の描1則をサポート 

PCJNTERIORS 

内部の飱り 


• LINECAPS の値 

LINECAPS (デバイスがサポートする線分描_能力）は、次の W の組み合わせ。 



意味 

LC 一 NONE 

線分をサポートしない 

LC.POLYLINE 

折れ線をサポート 

LC-MARKER 

マーカーをサポート 

LC_POLYMARKER 

ポリマーカーをサポート 

LC.WIDE 

幅のある線分をサポート 

LC-STYLED 

スタイルを持つ線分をサポート 

LC_WIDESTYLED 

スタイルを持ち、幅のある線分をサポート 

LCJNTERIORS 

内部の•屯りつぶしをサポート 


• POLYGON ALC APS の値 

POLYGONALCAPS (デバイスがサポートする多灼形描1山 i 能わ）は、次の fc 1 (の組み合わせ、 
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•TEXTCAPS の値 

TEXTCAPS (デバイスがサポートするテキストの表ボ能力）は、次の W の組み合わせ。 


总味 


TC OP CHARACTER 


TC OP STROKE 


TC CP STROKE 


TC CR 90 


文字出力精度をサポート。デバイスがデバイス 
フォントを ft 总のピクセル位 iW に; W けることを 
ポす。 この说は 、デバイスフォントを持つすべ 
てのデバイスに対して必要。 

ストローク出力粘度をサポート。デバイスがデ 
バイス フォン トの任总のストロークを略でき 
ることを示す。 

ストローククリップ 柄度を サポート する。 デバ 
イスがデバイスフオントをピクセル境界にクリ 
ップできることを示す。 

90 度の文字の回転をサポート。デバイスが文字 
を一度に 90 度だけ回 fc できることを示す。 


TC 一 CR ANY 


TC.SF X Y1NDEP 


TC SA DOUBLE 


TC_SA INTEGER 


TC_SA 一 CONTIN 


TC_EA_DOUBLE 


TCJA_ABLE 


任总の角度の文字の回 fc をサポート。デバイス 
が任总の角度でデバイスフォントを Mfe できる 
ことを示す。 

x ノ/[(»】と y /;•向の両/;•のスケーリングをサポー 
卜。デバイスが x 方向と y 方向に分けてデバイス 
フォントをスケーリングできることを示す。 

倍灼文字のスケーリングをサポート。デバイス 
がデバイスフォントのサイズを2倍にできること 
を示す。 

整数倍のスケーリングをサポート。デバイスが 
任立の粮数倍にデバイスフォントのサイズをス 
ケーりングできることを示す。 

任总の整数倍の正確なスケーリングをサポート。 
デバイスがデバイスフォントを任总の W でスケ 
ーリングでき、その上で x と y の比中を保つこと 
を示す。 

太字体の文字をサポート。デバイスがデバイス 
フォントに太字体を使えることを示す。ブリン 
タドライバでこのビットがセットされないとき、 
グラフイックデバイスインターフェイス ( GDI ) は 
文字を2回印 Wij して太字体のデバイスフォント 
を作成する。 

斜体をサポート。デバイスがデバイスフォント 
に斜体を使えることを示す。このビットがセッ 
卜されないとき、 GDI は斜体を使 H 1 できないも 
のと仮定する。 
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TC _ UA_ABLE 


TC _ SO_ABLE 


TC _ RA_ABLE 


TC 一 VA_ABLE 


TC_RESERVED 


下線をサポート0デバイスがデバイスフォント 
に下線を忖けられることを示す。このビットが 
セットされないとき、 GDI はデバイスフォント 
用の下線を作成する。 

打ち消し線をサポート0デバイスがデバイスフ 
ォントに打ち消し線をけけられることを示す。 
このビットがセットされないとき、 GDI はデハ # 
イスフォントの打ち消し線を作成する。 

ラスター フォントをサポート。 GDI が 
EnumFonts 数または EnumFontFamilies 閲数の 
呼び出しに応答して、このデバイスで利用でき 
る ft •总のラスターフォントや TrueType フォント 
を列爷することをボす。このビットがセットさ 
れないときは、これらの閲数が呼び出されたと 
きに、 GDI が供給するラスターフォントや 
TrueType フォントが列乎されない。 

ベクターフォントをサポート。 GDI が 
EnumFontsliH 数または EnumFontFamilies 閲数 
の呼び出しに応答して、このデバイスで利 HI で 
きる ff: 立のべクターフォントや TrueType フォン 
卜を列乎することを示す。これはベクターデバ 
イス(すなわちプロッタ)に対してだけイ J •効。 GDI 
はベクターフォントをドライバに送る前にラス 
タライズするので、ディスプレイドライハ•(ラス 
ターフォントの衣示能力を持つもの)とラスター 
プリンタドライバは、笊にベクター 
フォントを列乎する0 

予約。0でなければならない。 


民り値 正常終 r I 要求された値を返す 

参 照 CreateEnhMetaFile，CreatelC，DeviceCapabilities，GetDIBits，GetObjectType， 

SetDIBits，SetDIBitsToDevice，StretchBlt，StretchDIBits 
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GetGrai 

phicsMode 

gdir32.dll 

95 

NT 

デバイスコ 

ンテキストのカレントグラフィックモードの回復 


int GetGraphicsMode ( 

HDC hdc 


// デバイスコンテキストのハンドル 


V B 


パラメータ 
戻り値 



解説 


Declare Function GetGraphicsMode Lib ,, gdi 32" Alias ' GetGraphicsMode " (ByVal hdc 
As Long ) As Long 

•hdc デバイスコンテキストの識別子。 

関数が iEvT 口こ終了した坳合、グラフィックモードとして以卩の値が股定される。 


总味_ 


GM_COMPATIBLE カレントグラフィックモードは、 Windows バージョン 3.1 と互 

換性がある。このグラフィックモード内でアプリケーション 
は、指定されたデバイスコンテキストのワールド変換に設定す 
ることや史新ができない。互換性のあるグラフィックモード 
が、デフオルトのグラフィックモードである0 

GM_ADVANCED WindowsNT では、カレントグラフィックモードは向上したグ 

ラフィックモードであり、ワールド変換を許したモードであ 
る。このグラフィックモード内でアプリケーションは、指定さ 
れたデバイスコンテキストのワールド変換を設定したり史新す 
ることができる。 Windows 95では、 GM_ADVANCED はサポ 
ートされていない。 

それ以外 0 

GetGraphicsMode 関数は、指定されたデバイスコンテキストをカレントのグラフィッ 

クモードに回復する。 

アプリケーションは、 SetGraphicsMode 関数を呼び出すことによりデバイスコンテキ 

ストのグラフイックモードを設定できる。 

SetGraphicsMode 


GM ADVANCED 
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2.5 GDI インターフェイス 


GetMapMode 

gdi32.dll 

95 

NT 

カレントマッピングの取得 


V C 


V B 


パラメータ 
戻り値 


解説 


int GetMapMode ( 
HDC 

)； 


hdc 


// デバイスコンテキストのハンドル 


Declare Function GetMapMode Lib M gdi 32" Alias " GetMapMode " (ByVal hdc As 
Long ) As Long 


hdc 


ゴバイスコンテキストの識別子。 


止常終 r 
異常終 r 


マツピングモードを不す M 
〇 


GetMapMode |划数は、カレントマッピングモードを取得する 0 
マッピングモードは、以下の値のいずれかである。 




MM ANISOTROPIC 


MM HIENGLISH 


MM HIMETRIC 


MM ISOTROPIC 


MM LOENGLISH 


MM LOMETRIC 


MM TEXT 


MM TWIPS 


意味 


篇理単位は、任意にスケーリングされた袖ヒの任葸の単位に変 
換される。啉位、向き、スケーリングを指定するときには、 
SetWindowExtExlW 数と SetViewportExtEx 1划数を使う 0 

各論理単位は、0.001インチに変換される。 x 座嫖の正方向は 
右、 y 座標の正方向は t になる。 

各論押.単位は、0.01ミリメー トルに変換される。 x 座標の正方 
向は右、 y 座挖の正方向は上になる。 

各綸理単位は、等しく スケーリング された袖上の任意の単位に 
変換される。 xft 方向の丨単位は、 y 袖方向の丨举位と同じ。闽 
軸の蜞位と向きを指定するときには、 SetWindowExiExWJ 数と 
SetViewportExtEx 阅数を使う。 グラフ ィ ックデバイスイン ター 
フ ェ イス ( GDI ) は、 必要に応じて、 x 雄位と y 単位のサイズが同 
一になるように調整する(たとえば、 ウィン ドウ範 M を設定する 
とき、ビューボートが帒にその啉位が M じであるよう公わせる)。 

各論理単位は、0.01インチに変換される。 x 座標の正//向は右 
に、 y 座捺の£方向は上になる。 

各論理単位は、 0.1 ミリメー トルに変換される0 x 座標の正方向 
は“に、 y 座標の正方向は上になる。 

各論理単位は、1デバイスピクセルに変換される。 x 座標の正方 
向は右に、 y 座標の正方向は下になる。 

各論理唞位は、ポイント数の 20 分の 1(1440 分の 1 インチバこ変 
換される。 x 座標の正方向は右に、 y 座標の正方向は上になる。 


参 照 


SetMapMode , SetWindowExtEx,SetViewportExtEx 


GDIAV 分 —7 ha>4 
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GetViewportExtEx gdi 32 dii 

デバイスコンテキストのカレントビューボート範囲の取得 


95 


NT 


V C BOOL GetViewportExtEx ( 

HDC hdc ， // デバイスコンテキストのハンドル 

LPSIZE IpSize //ビューポート範_を取得する構造体へのポインタ 

)； 

V B Declare Function GetViewportExtEx Lib ” gdi 32” Alias " GetViewportExtEx'^By 

Val hdc As Long，IpSize As SIZE ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• IpSize SIZE 構造体へのボインタ。デバイス単位の x 範 W と y 範州がこの構造体 

に格納される。 

戻り値 正常終了 TRUE 

輿常終『 FALSE 

解説 GetViewportExtEx 閲数は、指定され たデバイスコンテキストのカレントビューポート 

の x 範 M と y 範[胡を取得する。 

^ 照 GetWindowExtEx , SetViewportExtEx,SetWindowExtEx 
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2.5 GDI インター 


GetWindowExtEx gdi 32 dii 


ンテキストに対応するウィンドウの範囲を取得 


V C 



BOOL GetWindowExtEx ( 
HDC hdc ， 

LPSIZE IpSize 


// デバイスコンテキストのハンドル 

//ウィンドウ範州を取得する構造体アドレス 


V B 


パラメータ 


戻り値 


解説 


Declare Function GetWindowExtEx Lib M gdi 32 M Alias " GetWindowExtEx ” (ByVal hdc 
As Long , IpSize As SIZE ) As Long 

- hdc デバイスコンテキストの識別子。 

• IpSize SIZE 構造体へのポインタ。ページ琳位の乂範叫と y 範叫がこの構造体に格 
納される。 


正帘終了 
異常終了 


TRUE 

FALSE 


GetWindowExtEx 関数は、指定されたデバイスコンテキストに対応するウィンドウの 
x 範[用と y 範 M を取得する。 

GetViewportExtEx ， SetViewportExtEx，SetWindowExtEx 
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第 2 章 Win 32 API リフっ 


GetWorldTransform 

gdi32.dll 

95 

NT 

ワールド空間か】 

E> ページ空間への変換の取得 


V C BOOL GetWorldTransform ( 

HDC hdc . // デバイスコンテキストのハンドル 

LPXFORM IpXfonn // 変換結果を取汾する構造体への ポ インタ 

)； 

V B Declare Function GetWorldTransform Lib M gdi 32" Alias " GetWorldTransform " (ByVal 

hdc As Long , IpXform As xform ) As Long 

パラメータ .hdc デバイスコンテキストのハンドル。 

• IpXform カレントのワールド空問よりページ空問へ変換した結 Mi を取する 

XFORM 構造体へのポインタ。 

戻り値 正常終了 TRUE 

輿常終了 FALSE 

解説 GetWorldTransform I 划数は、ワールド空問よりページ空問に変換した姑果を取得す 

る。 

アプリケーシヨ ンが GetWorldTransform 閲数を呼び出す的に ModifyWorklTransform 
I 対数を呼び出すと、変換の粘度は変史される (FLOAT 侦よりゝ初度を使う変換倘 
を保存するため内部フォーマットを作るため>。 

赛 w Modify WorldTransform,SetWorldTransform 
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2.5 GDI インターフコ 




V C 


BOOL LPtoDP ( 
HDC 
LPPOINT 


Me , // デバイスコンテキストのハンドル 

IpPoints ， //点の fid 列へのポインタ 
nCount //点の数 


V B 


パラメータ 


戻り値 


解脱 


Declare Function LPtoDP Lib ” gdi 32” Alias " LPtoDP ” (ByVal hdc As Long , IpPoint As 
POINTAPI，ByVal nCount As Long ) As Long 


•hdc 

• IpPoints 

• nCount 


正常終了 

異常終了 


デバイスコンテキストの識別子。 

POINT 構造体の配列へのボインタ。各 POINT 構造体の x 座標と y 座標 
は、変換される。 

配列の点の数を指定する。 


TRUE 

FALSE 


LPtoDP 開数は、論理座標をデバイス座標に変換する。変換はデバイスコンテキスト 
のマッピングモードや、ウィンドウとビューポートの原点と範181そしてワールド変換 
の設定により異なる。 

論理座標が32ビットを超えたときや変換したデバイス座挖が27ビットを超えたとき、 
この関数は失敗する。オーバーフローの埸合、すべてへのポインタは不確定である。 


DPtoLP，POINT 
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user32.dll 


95 


NT 



V C int MapWindowPoints ( 

HWND hWndFronu //マツプ元のウインドウのハンドル 

HWND hWndTo . //マツプ先のウインドウのハンドル 

LPPOINT IpPoints ， //マツプする POINT 構造体へのポインタ 
UINT cPoints //配列中の構造体の倜数 

)； 

V B Declare Function MapWindowPoints Lib M user 32 M Alias " MapWindowPoints " (ByVal 

hwndFrom As Long，ByVal hwndTo As Long，lppt As Any , ByVal cPoints As Long ) 
As Long 

パラメータ • hWndFrom 点の変換元のウィンドウの識別子。このパラメータが NULL または 

HWND _ DESKTOP のときは、点はスクリーン座標であると仮定さ 
れる。 

• hWndTo 点の変換先のウィンドウの識別子。このパラメータが NULL または 

HWND _ DESKTOP のときは、点はスクリーン座標であると仮定さ 
れる。 

• IpPoints 変換する座標を含む POINT 構造体の rtll 列へのポインタ。このパラ 

メータには、 RECT 構造体へのボインタを指定することもできる。 
この場合、パラメータに2を設定する。 

• cPoints IpPoints パラ メータが指す配列の POINTtf ? 造体の数を指定する。 

戻り値 阒数が正常に終 f した場合、戻り f め:の下位ワードには、それぞれの目標点の水平座 

掠を符出するため、基点の水平座標に; JIIP : されたピクセル数が,没定される。上位ワ 
ードには、それぞれの H 標点の垂|宵座挖を出するため、站点の垂遣;座標に; JHP : さ 
れたピクセル数が設定される。 

解説 MapWindowPoints I 划数は、点の堪合を、ウィンドウに扪対な座標空問からほかのウ 

ィンドウに相対な座摞空問へ変換(マップ)する。 

誉 照 ClientToScreen , POINT , RECT,ScreenToClient 
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2.5 GDI インターフコ 


ModifyWorldTransform [gdi 32 .dii | I_nt 

デバイスコンテキストのワールド変換 


V C BOOL ModifyWorldTransform ( 

HDC Me ， // デバイスコンテキストのハンドル 

CONST XFORM * IpXform ， //変換データのアドレス 
DWORD [Mode //変換モード 


V B Declare Function ModifyWorldTransform Lib " gdi 32" Alias ’ ModifyWorldTransform " 

(ByVal hdc As Long，IpXform As xform , ByVal iMode As Long ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• IpXform 与えられたデバイスコンテキストのワールド変換を史新するため使川 

される XFORM 構造体へのポインタ。 

• iMode 変換データをカレントのワールド変換に史新する方法を指定する。こ 

のパラメータには、以下の値が設定される。 

M [ 总味 

MWT.IDENTITY 同ーマトリツクスを使うことによりカレントのワールド変換を 

再設定する。このモードが衍定されたときは、 / pX / orm により指 
された XFORM 構造体は無祝される。 

MWT_LEFTMULTIPLY XFORM 梢造体のデータによりカレントの変換を W やす 

(XFORM 榊造体のデータは左の被乗数になる。カレントの変換 
のデータは右の被乗数になる)。 

MWT.RIGHTMULT1PLY XFORM 構造体のデータによりカレントの変換を增やす 

(XFORM 榊造体のデータは右の被乗数になる。カレントの変換 
のデータは左の被乗数になる)。 

戻り値 


解説 ModifyWorldTransform I 対数は、指定されたモードでデバイスコンテキストのワール 

ド変換を変える。 

ModifyWorldTransform I 对数は、あらかじめ SetGraphicsMode I 划数を呼び出し 
GM _ ADVANCED が設定されている指定されたデバイスコンテキストのグラフィック 
モードでなければ失敗する。なおかつ、ワールド変換が敁初に SetWorldTransforml 划 
数や ModifyWorldTransform 閲数を呼び出し、デフォルトの内部変換に再設定しなけ 
れば、デフォルトの GMJTOMPATIBLE モードにデハ♦イスコンテキストのグラフィッ 
クモードを再設定することはできない。 

参 照 GetWorldTransform , SetWorldTransform , SetGraphicsMode,XFORM 
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第 2 章 Win 32 API リファレンス 


OffsetViewportOr 



gdi32.dll 



NT 



ンテキストのビューポートをオフセツト移動 


V C 


V B 


パラメータ 


解脱 


BOOL OffsetViewportOrgEx ( 

HDC hdc ， //ドライブコンテキストのハンドル 

int nXOffset 、 //水平方向の オフセット 

int nYOffset 、 //垂直方向の オフセット 

LPPOINT IpPoint //オリジナルの原点を取得する構造体へのポインタ 
)； 

Declare Function OffsetViewportOrgEx Lib " gdi 32 H Alias " OffsetViewportOrgEx " 
(ByVal hdc As Long，ByVal nX As Long , ByVal nY As Long , IpPoint As POINTAPI ) 
As Long 


hdc 

nXOffset 
nY Offset 
IpPoint 


デバイスコンテキストの識別子。 

水平方向のオフセットをデバイス中位で指定する。 

垂直方向のオフセットをデバイス爭位で指定する。 

POINT 構造体へのポインタ。以前のビューポートの原点の座標がデバ 
イス単位でこの構造体に返される。ひが NULL のときは、以前の 
ビューポートの原点は返されない。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


OffsetViewportOrgEx 関数は、 デバイスコンテキストでのビューポートの原点の座標 
を指定され た 水平 • 垂直方向オフセッ ト により修正する。 

新しい原点は、直前の原点に水平 • 垂直方向オフセットを加兑した値になる。 


GetViewportOrgEx ， OffsetWindowOrgEx，SetViewportOrgEx 
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2.5 GDI インターフ] 


Off setWi ndowOrg Ex gdi32dii 95 nt 

デバイスコンテキストの原点をオフセツト移動 


V . C 


BOOL OffsetWindowOrgEx ( 

HDC hdc ， // デバイスコンテキストのハンドル 

int nXOffset ， // 水平方向のオフセット 

int nYOffset 、 // 垂直方向のオフセット 

LPPOINT IpPoint //オリジナルの原点を取得する構造体へのポインタ 


)； 


V B Declare Function OffsetWindowOrgEx Lib ” gdi 32" Alias M OffsetWindowOrgEx M 

(ByVal hdc As Long , ByVal nX As Long , ByVal nY As Long , IpPoint As POINT API ) 
As Long 


パラメータ 

• hdc 

デバイスコンテキストの識別子。 


• nXOffset 

水平方向のオフセットを論理単位で指定する。 


• tiYOffset 

垂直方向のオフセットを論理単位で指定する。 


• IpPoint 

POINT 構造体へのポインタ。以前のウィンドウの原点の論理座摞でこ 
の構造体に返される。/尸/^/ m が NULL のときは、以前のビューポート 
の原点は返されない。 

戻り 値 

正常終了 

TRUE 


輿常終了 

FALSE 


解説 OffsetWindowOrgEx 閲数は、 デバイスコンテキストでのウィンドウの 原点を、指定 

された水平 • 垂直方向オフセットにより修正する。 

参 照 GetViewportOrgEx , OffsetViewportOrgEx,POINT 
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第 2 章 Win32 API U フつ 



ortExtEx 

gdi32.dll 

95 

NT 


デバイスコンテキストのビューポートを指定率でリサイ 


V C BOOL Scale V iewportExtEx ( 

HDC hdc , // デバイスコンテキストのハンドル 

int Xnum . //水平方向に掛ける侦 

int Xdenont ， //水、 F - 方向を割る値 

int Ynunu //垂歲方向に掛ける M 

int Ydenotn ， //垂 商方向を; 1 Pj る侦 

LPSIZE IpSize //以前の ビューポート 笵關 へのポインタ 

)； 


V B Declare Function ScaleViewporlExtEx Lib M gdi 32" Alias " ScaleVievvportExtEx " (ByVal 

hdc As Long , ByVal nXnum As Long , ByVal nXdenom As Long , ByVal nYnum As 
Long , ByVal nYdenom As Long，IpSize As SIZE ) As Long 

パラメータ • hck デバイスコンテキストの識別子。 

• Xnum 現在の水平方向に掛ける値を指定する。 

• Xdetiom 現 / fi の水平方向を割る flft を衍定する。 

• Ynum 現在の联ぬ:方向に掛ける航を指定する。 

• Ydenom 現在の每槪方向を割る倘を指定する。 

• IpSize SIZE 構造体へのボインタ。以前のビューポート範陳デバイス职、 >:) は、 

この榊造体に格納される。か5/•びが NULL のときは、何も返されない。 

戻り値 


解説 


参 照 


ScaleViewporlExtEx 閲数は、 デバイスコンテキストの ビュー ポートの 範關を指定され 
た掛ける値や割る値で形成された剤合により修正する。 

ビューポート範洲は、以下のように修正される。 
xNewVE =( x 01 dVE * XA ? M //2) / Xdenom 
yNewVE =( y 01 dVE * Km " n ) / Ydenom 

GetViewportExtEx，SIZE 
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2.5 GDI インターフ 


ScaleWindowExtEx gdi32dii 95 nt 

デバイスコンテキストのウインドウを指定率でリサイズ 


V C 

V B 

パラメータ 

戻り値 

解説 

参 照 


BOOL ScaleWindowExtEx( 


HDC 

hdc\ 

// デバイスコンテキストのハンドル 

int 

Xnum, 

//水平方向に掛ける値 

int 

Xdenom, 

//水平方向を割る値 

int 

Ynum, 

//垂直方向に掛ける値 

int 

Ydenom ， 

//垂直方向を割る値 

LPSIZE 

IpSize 

//以前のウィンドウ範關のアドレス 


)； 

Declare Function ScaleWindowExtEx Lib "gdi32" Alias "ScaleWindowExtEx" (ByVal 
hdc As Long，ByVal nXnum As Long, ByVal nXdenom As Long，ByVal nYnum As 
Long, ByVal nYdenom As Long，IpSize As SIZE) As Long 

- hdc デバイスコンテキストの識別子。 

• Xnum 現在の水平方向に掛ける値を指定する。 

• Xdetiom 現在の水、ドノ/向を?} ll る値を指定する。 

• Ynum 現在の垂商方向に掛ける値を指定する。 

• Ydenom 現在の垂茛方向を削る値を指定する。 

• IpSize SIZE 構造体へのポインタ。以前のウィンドウ範 bH (論理墘位)は、この 

構造体に格納される。 //?S/ びが NULL のときは、何も返されない。 

正帘終 r I TRUE 
異常終了 FALSE 

ScaleWindowExtEx 関数は、 デバイスコンテキス トのウィンドウを指定された掛ける 
値や割る値で形成された別合により修正する。 

ウィンドウ範囲は、以下のように修正される。 
xNewWE=(x01dWE*Xm"«) / Xdenom 
yNewWE=(y01dWE*K/zwm) / Ydenom 

GetWindowExtEx，SIZE 
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第 2 章 Win32 API リファレンス 


ScreenToClient 

user32.dll 

95 

NT 

スクリーン座標をクライアント座標に変換 





V C 


V B 

パラメータ 


戻り値 


解説 


参 照 


BOOL ScreenToCIient( 

HWND hWnd. // ソース座標のウ イン ドウの ハン ドル 

LPPOINT IpPoint // 座標の構造体へのポインタ 

)； 

Declare Function ScreenToClient Lib U user32" Alias "ScreenToClient" (ByVal hwnd As 
Long, IpPoint As POINTAFI) As Long 

• hWnd 座標が変換されるクライアント領域を持つウィンドウの識別子。 

• IpPoint 変換されるスクリーン座標を格納している、 POINT 構造体へのポイン 

夕〇 


正常終了 TRUE 

異常終了 FALSE 

ScreenToClient 関数は、画面上の指定された点のスクリーン座標をクライアント座標 
に変換する。 

この関数は、 /iVVm/ パラメータにより識別されるウィンドウを使い、 POINT 構造体の 
スクリーン座標をクライアント座標に算出する。新しい座標は、指定されたウィン 
ドウのクライアント領域の左上隅からの相対座標になる。 

ScreenToClient 閲数は、指定された点をスクリーン座標として仮定する 0 


ClientToScreen.MapWindowPoints,POINT 


SetGraphicsMode 

gdi32.dll 

95 

NT 

デバイスコンテキストのグラフィックモード設定 


V C 


V B 


パラメータ 


int SetGraphicsMode( 

HDC hdc ， // デバイスコンテキストのハンドル 

int Mode // グラフィックモード 

)； 

Declare Function SetGraphicsMode Lib "gdi32" Alias "SetGraphicsMode" (ByVal hdc 
As Long, ByVal iMode As Long) As Long 

- hdc デバイスコンテキストのハンドル。 

• iMode グラフ イック モードを指定する。このパラメータには以下の値が設定さ 
れる。 
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2.5 GDI インターフェイス 


Vi . 

意味 

GM.COMPATIBLE 

カレントグラフィックモードは、 Windows3.1 と互換性がある。 
これがデフオルトモードである。アプリケーションは、 
SetViewportExlExliil 数や SetWindowExtEx 閲数を呼び出すこと 
で、ワールド変換からデバイス変換に史新できる。 

GM.ADVANCED 

WindowsNT では、ワールド変換を,汗したグラフィックモードを 
設定する。アプリケーションが指定されたデバイスコンテキス 
卜のワールド変換を設龙したり史新するときは、この W を設定 
する。すべてのグラフィックで、テキスト出力を含むこのモー 
ドは、指定されたデバイスコンテキストでワールドからデバイ 
ス変換を完全に行う 0 Windows 95 では、 GM_ADVANCED は 
サポートされていない。しかし、エンハンストメタファイルは 
GM_ADVANCED モードで灾行されると仮定される 0 Windows 
95 は、エンハンストメタファイルを WindowsNT と同じように 
見せることを保証する。 


戻り値 

正常終 r 

以前のグラフィックモード 


興常終了 

0 


解説 SetGraphicsMode_ 数は、指定されたデバイスコンテキストのグラフィックモードを 

設定する。 

グラフィックモードにより異なるグラフィック出力には 3 つの領域がある。 

1. テキスト出力。 GM_COMPATIBLE モードで、 TrueType (またはベクトルフォント) 
のテキスト出力は、デバイスコンテキストのワールドからデバイスへの変換に合 
わせるラスタフォントのテキスト出力と同様の®/作をする。グラフィックの舴止 
位竹が x 軸や y 軸に回されるとき、 TrueType のテキストは、左側から右側へ上 
から W かれる。 TrueType (またはべクトルフォント）のテキストは、適当な高さに 
決まる。 GM_COMPAT〖BLE モードで水平でないテキストを巧く方法は、デバイ 
スコンテキストで選択された論理フォントに〇でな I 、傾斜と方向を指定する。 
GM_ADVANCED モードでは、 TrueType (またはべクトルフォント）のテキスト出力 
は、デバイスコンテキストのワールドからデバイスへの変換に合わせる。ラスタ 
ーフォントが限定された変換能力を持つ。グラフィックデバイスインターフェイ 
ス (GDI) は、特殊な変換のためラスターフォントを持ち、の出力を行おうとす 
る。 

2. 矩形の排除。デフォルトの GM_COMPATIBLE グラフィックモードが設定された 
ときは、システムは矩形を描くときに、下部と W 右端を除外する。アプリケーシ 
ョンが右下を含めた矩形を描くときは、 GM_ADVANCED グラフィックモードが 
要求される。 

3. 弧の描幽。デフォルトの GM_COMPATIBLE グラフィックモードが設定されたと 
きは、 GDI はデバイス空問にカレントの弧の方向に向けて弧を描く。この約束の 
中で、弧は x 軸や y 軸に沿った転回を要求するページからデバイスへの変換を礙先 
しない。 


GDIA V 分 —7 ha>4 
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GM—ADVANCED グラフイックモードが設定されたとき、 GD 〖は論理空間に左回 
りの方向に弧を描く。これは、 GM_ADVANCED グラフィックモードで弧の制御 
点と弧自体がデバイスコンテキストのワールドからデバイスへの変換を说先する 
ということである。 


参 照 CreateDC , GetArcDirection , GetDC , GetGraphicsMode , ModifyWorldTransform , 

SetArcDirection , SetViewportExtent , SetViewportExtEx , SetWindowtxtent , 

SetWindowExtEx,SetWorldTransfonn 


SetMapMode 

gdi32.dll 

95 

NT 

デバイスコンテキストのマッピングモード設定 


V C 

V B 

パラメータ 


int SetMapMode ( 

HDC hdc % // デバイスコンテキストのハンドル 

int fnMapMode //新しいマッピングモード 

)； 


Declare Function SetMapMode Lib " gdi 32" Alias " SetMapMode ” (ByVal hdc As Long ， 
ByVal nMapMode As Long ) As Long 


- hdc デバイスコンテキストの,裁別子。 

- fnMapMode 新しいマッピングモードを指定する。このパラメータは、以卩の侦 

のいずれかになる。 


W_ 

MM 


_总味_ 

ANISOTROPIC ，論理琳位は、仟总にスケーリングされた軸 I •.の任立の中位に変 

換される。琳位、向き、スケーリングを指定するときには、 


SetWindowExtEx 閲数と SetViewportExtEx 明数を使う 0 


MM HIENGLISH 


各鎗理蜞位は、0.001インチに変換される。 x 座標の正方向は 
右、 y 座抒の正方向は上になる。 


MM.HIMETRIC 

MM ISOTROPIC 


MM_LOENGLISH 

MM_LOMETRIC 

MM TEXT 


各論理¥位は、 0.01 ミリメー トルに変换される。 x 座標の正方 
向は右、 y 座挖の正方向は上になる。 

各論理単位は、等しくスケーリングされた帕 h の任意の単位に 
変換される。 x # 方向の丨举位は、 y _ 方向の1単位と同じ。両 
ft の単位と向きを衍定するときには、 SetWindowExtEx 関数と 
SetViewportExtEx 問数を使う。グラフィックデバイスインター 
フェイス ( GDI ) は、必®に応じて、 x 中位と y 出位のサイズが M 
一になるように僚する(たとえば、ウィンドウ範 W を股定する 
とき、ビューポートが常にその 4 MA が M じであるよう合わせる)。 

各論理蜞位は、0.01インチに変換される。 x 座標の正方向は右 
に、 y 座榡の正方向は上になる。 

各論理単位は、 0.1 ミリメートルに変換される。 x 座標の正方向 
は右に、 y 座標の正方向は上になる。 

各論理增位は、 I デバイスピクセルに変换される。 x 座 R の正方 
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向は右に、 y 座標の正方向は下になる。 

MM.TWIPS 各論理甩位は、ポイント数の 20 分の 1(1440 分の 1 インチ)に変 

換される。 x 座挖の正方向は右に、 y 座挖の£方向は上になる。 


正常終 r 以前のマッピングモード 

異常終了 〇 

SetMapMode 関数は、指定されたデバイスコンテキストのマッピングモードを設定す 
る。マッピングモードとは、ページ啉位をデバイス墘位に変換するときの比率を定義 
し、デバイスの x 軸と y 軸の向きも合わせて定義する。 

MMJTEXT モードを使用すると、アプリケーションは1ピクセルを1論理墘位とする 
デノ《イスピクセル¥位で作業できる。 

MM _ H 1 ENGLISH 、 MM _ HIMETR 1 C 、 MMJLOENGLISH 、 MM _ L 0 METR 1 C 、 
MM _ TWIPS のモードは、アプリケーションが物理単位（インチやミリメー トルなど) 
で描幽するときに便利である。 

MMJSOTROPIC モードは縦横比が1:1である。 MM _ ANlSOTROPIC モードを使 111 す 
ると、 x 座標と v 座標を調節できる。 


GetMapMode , SetViewportExtEx , SetViewportOrgEx , SetWindowExtEx , 

SetWindowOrgEx 
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SetViewportExtEx 



ンテキストのビューボー 


gdi 32 .dll 95 

の水平垂直方向範囲設定 


NT 


V C BOOL Set V iewportExtEx ( 

HDC hdc ， // デバイ ス コンテ キストの ハンドル 

int nXExtent ， //新し\ 、水平方向のビューポート範 M 

int nYExtent . //新しい垂直方向のビューポート範 W 

LPSIZE IpSize //オリジナルなビューポート範囲 

)； 


V B Declare Function SetViewportExtEx Lib " gdi 32” Alias " SetViewportExtEx " (ByVal hdc 

As Long , ByVal nX As Long , ByVal nY As Long，IpSize As SIZE ) As Long 

パラメータ .hdc デバイスコンテキストの識別子。 

• nXExtent ビューポートの水平方向範囲をデバイス¥位で指定する。 

• nYExtent ビューポー トの 垂直方向範囲をデバイ ス取 位で指定す る。 

• IpSize SIZE 構造体へのボインタ。以前のビューポート範囲(デバイス职位)は、 

この構造体に格納される。 / pAze が NULL のときは、何も返されない。 

戻り値 正常終了 TRUE 

異常終了 FALSE 


解脱 SetViewportExtEx 閲数は、指定された値によりデバイスコンテキストのビューポート 

の水平方向と垂直方向の範囲を設定する。 

次のマッピングモードを設定した增合 、 SetWindowExtEx _数および Set View 
portExtExlJy 数への呼び出しが無視される。 

MM_HIENGLISH MM 一 LOMETRIC 

MM.HIMETRIC MM_TEXT 

MM.LOENGLISH MM.TWIPS 

MMJSOTROPIC モードを設定したときには、アプリケーションは SetViewportExtEx 
I 対数を呼び出す前に SetWindowExtEx 関数を呼び出さなければならない。 

参 照 GetViewportExtEx , SetWindowExtEx,SIZE 
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SetWindowExtEx 


ンテキストの水平垂直方向の範囲設定 


gdi 32 .dll 



V C 


V B 


パラメータ 


解説 


BOOL SetWindowExtEx ( 

HDC hdc ， // デバイスコンテキストのハンドル 

int nXExtent ， //新い 、水平方向のウィンドウ範 [fli 

int nYExtent ， //新し、 、唾®:方向のウィンドウ範囲 

LPSIZE IpSize //オリジナルなウィンドウ範開 

)； 

Declare Function SetWindowExtEx Lib " gdi 32" Alias " SetWindowExtEx " (ByVal hdc 
As Long , ByVal nX As Long，ByVal nY As Long，IpSize As SIZE ) As Long 


• hdc 

• nXExtent 

• nY Extent 

• IpSize 


正常終了 
與常終了 


デバイスコンテキストの識別子。 

ウィンドウの水平方向範囲を論理蝌位で指定する0 
ウィンドウの垂直方向範囲を論理唞位で指定する。 

SIZE 構造体へのボインタ。以前のウィンドウ範 W (論理単位)は、 
構造体に格納される。 / pS / びが NULL のときは、 M も返されない c 


TRUE 

FALSE 


この 


SetWindowExtEx I 対数は、指定された M によりデバイスコンテキストのウィンドウの 
水平方向と垂斑方向の範囲を設定する。 

次のマッピングモードを設定した場合、 SetWindowExtEx 関数および 
Set Viewport ExtEx 閲数への呼び出しが無視される。 

MM HIENGLISH MM LOMETRIC 


MM HIMETRIC 


MM TEXT 


MM _ L 0 ENGL 1 SH MM 一 TWIPS 

MMJSOTROPIC モードを設定したときには、アプリケーシヨンは SetViewportExtEx 
数を呼び出す前に SetWindowExtEx I 対数を呼び出さなければならない。 


Get \ VindowExtEx ， SetViewportExtEx，SIZE 
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SetWorldTransform 


2次元線分の変換 



gdi 32 .dll 


V C 


V B 


パラメータ 


戻り fi 


解脱 


BOOL SetWorldTransform ( 

HDC hdc ， 

CONST XFORM * IpXform 

)； 


// デバイスコンテキストのハンドル 
//変換データのアドレス 


Declare Function SetWorldTransform Lib " gdi 32" Alias ' SetWorldTransform M (ByVal 
hdc As Long，IpXform As xform ) As Long 

- hdc デバイスコンテキストの識別子。 

• IpXform 変換データを格納する XFORM 構造体へのボインタ。 


正常終了 

異常終了 


TRUE 

FALSE 


SetWorldTransfonnl 対数は、指定されたデバイスコンテキストのワールド空問とぺ一 
ジ空間の間に2次元の線の変換を設定する。この変換は、スケール、回虹、ひずみ 
を使ったり、グラフィック出力に変えることができる。 

ワールド空問の座標 ( x ， y ) より、ページ空問の座掠の変換 ( x \ ゾ>は以下のアルゴリズム 
で剤り出せる。 

x '= x*eM 1 l + y * eM 21+ eDx , 
y ’= x*eM 1 2+ y * eM 22+ eDy , 

変換マトリックスは以下に示す。 
leMlleM120l 
leM 21 eM 220 l 
leDxeDy 1 1 

マッピングモード（カレントウィンドウとビューポイント範開の原点により定義され 
る)は、啉位とスケールを定義するために役立つ。 

ワールド変換には、デバイス独自の方法で描くスケールや回率ムが使用される。デフ 
オルトワールド変換は、〇オフセットの内部マトリックスである。 
SetWorldTransform 関数は、あらかじめ SetGraphicsMode 開数を呼び出し 
GM . ADVANCED が設定されている与えられたデバイスコンテキストのグラフィック 
モードでなければ失敗する。なおかつ、ワールド変換が〗初に SetWorldTransform 
数や ModifyWorldTransform 関数を呼び出し、デフォルトの内部変換に洱設定しなけ 
れば、デフオルトの GM _ COMPATIBLE モードにデノくイスコンテキストのグラフィッ 
クモードを再設定することはできない。 

Get WorldTransform , Mod ifyWorldTransform , SetGraphicsMode,Set MapMode , 
SetViewportExtEx , SetViewportOrgEx , SetWindowExtEx , SetWindowOrgEx,XFORM 
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| Device Context 

斑 

ChanaeDisplaySettings 


95 

NT 

ディスプレイセッティングの変更 


V C LONG ChangeDisplaySettings( 

LPDEVMODE IpDevMode ， //DEVMODE 構造体へのポインタ 
DWORD dwflags // デイスブレイモード設定フラグ 

)； 

パラメータ • IpDevMode DEVMODE 構造体へのポインタ 〇 dmSize メンバを利 HI して、サイ 

ズの初期化を行う。指定する値は次の値のいずれかになる。 


メ ンバ 

意味 

dmBitsPerPel 

ビットあたりのピクセル 

dmPelsWidth 

ピクセルの幅 

dmPelsHeight 

ピクセルの卨さ 

dmDisplayFlags 

_面モードフラグ 

dmDisplayFrequency 

リフレッシュレー ト 


上の値を DEVMODE メンバに設定するだけでなく、適切なフラグも dmFields メンバ 
にセットしなければならない。フラグは、ディスプレイセッティング変史のために、 
DEVMODE 構造体のどのメンバが使われるかをポす。正しいフラグ設定が行われて 
いない場合には、変更は反映されない。次のフラグのうちの1つ以上を設定する。 


フラグ 

总味 

DM_BITSPERPEL 

dmBitsPerPel を利用する 

DM.PELSWIDTH 

dmPelsWidth を利用する 

DM.PELSHEIGHT 

dmPelsHeight を利用する 

DM.DISFLAYFLAGS 

dmDisplayFlags を利用する 

DM_DISPLAYFREQENCY 

dmDisplayFrequency を利用する 


IpDevMode が NULL のとき、 すべての値は現在のレジストリ怡報が利⑴される。泐的 
なモード変化の後にデフオルトのモードへ保すために M も簡単な方法である。 
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• dwflags モードがどのように変更されるかを示す。次の値のいずれかを指 


定する。 


フラグ 

意味 

0 

グラフィックモードは動的に変更される。 

CDS-UPDATEREGISTRY 

グラフィックモードは! K ; 的に変史され、レジストリデ 
ータベース、ユーザープロファイルに登録される。 

CDSJTEST 

CDS _ UPDATEREGISTRY が指定されて、グラフィッ 
クモードを勋的に変史することが可能ならば、怡報が 
レジストリに登鉍されて、 DISP . CHANGE . 
SUCCESSFUL が返される。グラフィックモードを動 
的に変史することができな1ゝ坳合には、怡報がレジス 
トリに登録されて、 D 1 SP _ CHANGE _ RESTART が返 
される。 


Windows NT :怙報がレジストリに登録されなかった坳合、グラフィックモードは 

変更されず 、 DISP CHANGE NOTUPDATED が返される。 


戻り値 次の倘のいずれかを返す。 


m 

意味 

DISP 一 CHANGE 一 SUCCESSFUL 

設定変更が正常に行われた 

DISP _ CHANGE_RESTART 

コンピュータを再起動しなければならない 

DISP — CHANGE_BADFLAGS 

フラグ設定が正しくない 

DISP 一 CHANGE 一 FAILED 

新し t ゝ設定の表示に失敗した 

DISP 一 CHANGE 一 BADMODE 

サポートされない設定を指定した 

DISP 一 CHANGE 一 NOTUPDATED 

WindowsNT :レジストリ怙報の〇!•新に失敗した 


解説 EnumDisplaySettings 関数から返された DEVMODE 構造体を使うことで 、 Change 

DisplaySettings で利川する DEVMODE 構造体の設定が有効であることが保証される。 
衣示モードが勑的に変史されるときには、 WM_DISPLAYCHANGE メッセージは以 
ドのメッセージパラメータによって動作中のすべてのアプリケー ショ ンに送られる。 


パラメータ 

意味 

wParam 

ピクセルごとの新しいビット数 

LOWORD (/ Param ) 

新しいピクセル tei 

HIWORD (//^ mm ) 

新しいピクセル岛さ 


参 照 — CreateDC ，— DEVMODE ’ EnumDisplavSettings ，— WM_DISPLAYCHANGE 
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HDC CreateDC ( 
LPCTSTR 


IpszDriver , 

IpszDevice , 

IpszOutput , 


V B 


LPCTSTR IpszDriver , / AVindows 3.1 と同じ閲数プロトタイプを使 

うためだけのもの 

LPCTSTR IpszDevice , //サポートしているプリンタの名前を指定 

LPCTSTR IpszOutpuU / AVindows 3. 1と同じ閲数プロトタイプを使 

うためだけのもの 

CONST DEVMODE *lplnitData //初期化怡報を含む DEVMODE 構造体への 

ポインタ 

)； 

Declare Function CreateDC Lib " gdi 32” Alias ' CreateDCA '' (ByVal lpDriverName As 
String , ByVal lpDeviceName As String , ByVal lpOutput As String , lpInitData As 
DEVMODE ) As Long 


パラメータ 


IpszDriver 


IpszDevice 


IpszOutput 


lpInitData 


戻り値 


正常終了 
輿常終了 


NULL で終わる文字列である。通常、ディスプレイドライバには 
" DISPLAY "、 プリンタドライバには " WINSPOO じを指定する。 
Win 32 において、このパラメータは無祝される。このパラメータは、 
Windows 3.1 と同じ関数プロトタイプを使うためだけのものである。 
NULL で終わる文字列を指すポインタである。サポートしているプリ 
ンタの名前を指定する。 

NULL で終わる文字列を指すポインタである。 Win 32 において、この 
パラメータは無視される。このパラメータは、 Windows 3.1 と同じ閲 
数プロトタイプを使うためだけのものである。 

デバイスドライバのためのデバイス固有の初期化怡報を含む 
DEVMODE 構造体へのポインタである。 DocumentProperties 閲数は、 
指定されたデバイス川の怙報を持つこの構造体を取得する。ユーザー 
が Windows のプリントマネージャで指定したデフォルトの初期化怙報 
をデバイスドライバが使⑴する埸合、 / pv / m 7 Da 如パラメータは NULL 
でなければならない。 


デバイ スコンテキストのハンドル 

NULL 


解説 


指定された名前で示されるデバイスに対するデバイスコンテキストを作成する0 
DocumentProperties ，— DEVMODE 
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CreateDC 


gdi 32 .dll 


NT 


95 
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DeleteDC 

gdi 32 .dll 

95 

NT 

デバイスコ 

ンテキストの削除 


V C BOOL DeleteDC ( 

HDC hdc // デバイスコンテキストのハンドル 


V B Declare Function DeleteDC Lib M gdi 32" Alias " DeleteDC ' (ByVal hdc As Long ) As 

Long 

パラメータ .hdc 削除するデバイスコンテキスト。 

戻り値 止: VT 浓 f TRUE 

異常終了 FALSE 

解説 指定されたデバイスコンテキストを削除する。 

アプリケーションは、 GetDC 関数を呼び出して取 IU したデバイスコンテキストのハン 
ドルを削除してはならない。この坳合、 ReleaseDClW 数を呼び出してデバイスコンテ 
キストを解放しなければならない0 

^ 照 - ♦ CreateDC ,— GetDC，ReleaseDC 
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V C HDC GetDC ( 

HWND hwnd // デバイスコンテキストを 取得す るウインドウ 


V B Declare Function GetDC Lib " user 32" Alias " GetDC ” (ByVal hwnd As Long ) As Long 

パラメータ • hwnd デバイスコンテキストを 取す るウィンドウを 識別す る 0 

戻り値 正常終了 デバイスコンテキストのハンドル 

mm T NULL 

解説 指定されたウィンドウのクライアント領域に対応するデバイスコンテキストのハンド 

ルを 取得する 0 以降、 このデバイスコンテキストは、グラフィックデバイスインター 
フェイス ( GDI ) 関数で クライアン ト領域内を描 _ するときに利用可能になる。 GetDC 
I 対数は、指定された ウィンドウのクラススタイル により、共通、 クラス、 または プラ 
イペートのデバイスコンテキス トを取得する。共 M デバイスコンテキストでは、 取得 
するたびに GetDC _ 数が デフォルトの M 性を剤り当てる。 クラスコンテキス トおよび 
プライベートコンテキストでは、 以前の诚性を変更せずにそのまま;明り 3 てる。 

共通デノ《イスコンテキストを使って描_した後でデノ くイスコンテキストを解放するに 
は、 ReleaseDC _ 数を呼び出さなければならない。クラスデバイスコンテキストやプ 
ライべートデバイスコンテキストは解放する必赀がない。デバイスコンテキストの数 
は、利川可能なメモリの M によってのみ制限される。 

梦 照 ReleaseDC,GetWindowDC 


ンテキストのハンドルを取得 


GetDC 


user 32 .dll 


95 


NT 


GDI A V 分 — ： 7ha >4 



c/ 
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Filled Shape _ 


Ellipse 

gdi32.dll 

95 

NT 

楕円の描画 


V C 

V B 

パラメータ 


戻り値 


解説 

参 照 


BOOL Ellipse ( 


HDC 

hdc 

int 

nLeftRect 

int 

nTopRect 

int 

nRightRect 

int 

nBottomRect 


//デバイスコンテキストを識別 
//外接する長方形の左上隅の論理 X 座標を指定 
//外接する長方形の左上隅の論理 y 座標を指定 
//外接する於方形の右ド隅の論理 x 座控を指定 
//外接する長方形の右ド隅の論理 y 座標を指定 



Declare Function Ellipse Lib " gdi 32" Alias " Ellipse " (ByVal hdc As Long，ByVal XI 
As Long，ByVal Y 1 As Long，ByVal X 2 As Long，ByVal Y 2 As Long ) As Long 


•hdc 

• nLeftRect 

• nTopRect 

• nRighlRect 

• nBottomRect 


デバイスコンテキストのハンドルを 指定する。 
外接する長方形の左上隅の論理 X 座榡を指定する。 
外接する長方形の左上隅の論理 y 座挖を指定する。 
外接する長方形の右下隅の論理 x 座搮を指定する。 
外接する長方形の右下隅の論理 y 座挖を指定する。 


正你終了 TRUE 

輿常終了 FALSE 

拡張エラー怙報を取得するには、 GetLastError 開数を利用する。 


梢 I リ形を描碑 i する。梢円形の中心は指定された及方形の中心になる。楕円形は現在 
のペンで描かれ、その内部は現在のブラシで塗りつぶされる。 

カレントポジションはこの関数によって使用されず、また変吏されることもない。 


Arc’ArcTo 
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FillRect 

user 32 .dll 

95 

NT 

指定のブラシを使用して、指定された長方形を塗りつぶす 


V C BOOL FillRect ( 


HDC 

hDC ， 

// デバイスコンテキストのハンドル 

CONST RECT 

* lprc ， 

// RECT 構造体への ポインタ 

HBRUSH 

hbr 

//ブラシハンドル 


)； 

V B Declare Function FillRect Lib " user 32" Alias " FillRect " (ByVal hdc As Long，IpRect As 

RECT，ByVal hBrush As Long ) As Long 


パラメータ • hDC デバイスコンテキストを識別するハンドルを指定。 

- Iprc 塗りつぶす長方形を含む RECT 構造体へのボインタ。 

• hbr 於方形を塗りつぶすために使用するブラシのハンドルを指定。 


戻り値 

正常終 r 

TRUE 


輿常終了 

FALSE 


拡張エラ ー M •報は GetLastErrorl 划数で取得。 

— CreateHatchBrush ，— CreatePattemBrush ，— CreateSolidBrush ’ GetStockObject , 
—RECT 


gdiav s^i vj h-\>4 
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Pie gdi 32 .dll 95 NT 

扇形を描画 _ 

V C BOOL Pie ( 


HDC 

hdc . 

// デバイスコンテキストを識別するハンドル 

nt 

nLeflRect , 

//外接する四角形左上职点を示す x 座掠 

nt 

nTopRect 、 

//外接する四角形左上 m 点を示す y 座挖 

nt 

nRightRect , 

//外接する四角形右下項点を示す X 座搮 

nt 

nBottomRect , 

//外接する四角形右ド m 点を示す y 座掠 

nt 

nX Radial I % 

// R 弧の開始点を示す X 座標 

nt 

nY Radial ! % 

//円弧の冏始点を示す y 

nt 

nXRadial 2, 

//円弧の終了点を示す X 座標 

nt 

n YRcidial 2 

//円弧の終了点を示す y 座標 


)； 

V B Declare Function Pie Lib " gdi 32” Alias " Pie " (ByVal hdc As Long，ByVal XI As Long ， 

ByVal Y 1 As Long，ByVal X 2 As Long , ByVal Y 2 As Long，ByVal X 3 As Long , 
ByVal Y 3 As Long , ByVal X 4 As Long , ByVal Y 4 As Long ) As Long 

パラメータ .hdc デバイスコンテキストを•裁別するハンドル 

• nLeflRect 外接する四角形左上項点を示す x 座標 

• nTopRect 外接する叫角形左上項点を示す y 座標 

• nRightRect 外接する四角形右下点を示す x 座挖 

• nBottomRect 外接する四角形右下泊点を示す x 座技 

• nX Radial I 1リ弧の開始点を示す x 座標 

• nYRadial 1 円弧の開始点を示す y 座標 

• nXRculiaH I 1 j 弧の終了点を示す x 座標 

• /! YRadial 2 I リ弧の終了点を示す y 座標 

戻り値 正常終 f TRUE 

輿常終了 FALSE 

拡张エラー怡報は GetLastErroi •関数で取得。 

解説 PielW 数はパラメータで指定された座技空問に扇形を描圃する。座標の指定は外接す 

る M 方形を示す2点の座標と円弧の開始と終了の2点により行う。この数の実行に 
よってカレントポジションが更新されることはない。 

赛 ^ AngleArc ， Arc ， ArcTo，Chord 
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2.5 GDI インターフ 



on 

gdi 32 .dll 

95 


多角形を描画 



▽ C BOOL Polygon ( 

HDC hdc , // デバイスコンテキストを 識別する ハンドル 

CONST POINT * lpPoints ， //多角形の頂点を示す POINT 構造体へのポインタ 
int nCount //多角形の頂点の数を示す数値 

)； 

V B Declare Function Polygon Lib " gdi 32” Alias " Polygon " (ByVal hdc As Long，IpPoint As 

POINTAPI , ByVal nCount As Long ) As Long 


パラメータ .hdc デバイスコンテ キストを識別する ハンドル。 

• IpPoints 多角形の湏点座標を定義した POINT 構造体配列へのボインタ。 

• nCount POINT 構造体で定義された配列に含まれる頂点の数を指定する。ここで 

指定される値は2以上でなければならない。 

戻り 値 

拡張エラー怡報は GetLastError 関数で取得。 

解脱 Polygon 関数は多角形を描画する。 POINT 構造体配列で指定する頃点の始点と終点 

は、自動的に線分で結ばれ閉じた図形が生成される。この関数によってカレントポ 
ジションが更新されることはない。 

香 照 GetPolyFillMode ，— POINT ， Polyline ， PolylineTo ， PolvPolygon，SetPolyFillMode 
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DrawText 

user 32 .dll 

95 

NT 

テキストの描画 


V C 


V B 


パラメータ 


int DrawText ( 


HDC 

hdc 

" デバイスコンテキストを識別 

LPCTSTR 

IpszStr 

//描両する文字列へのポインタ 

int 

cchStr 

//文字列の文字数を指定 

LPRECT 

Iprc 

// RECT 構造体へのポインタ 

UINT 

wFormat 

//テキストの咨式化方法 


)； 

Declare Function DrawText Lib ,, user 32 M Alias " DrawTextA ” (ByVal hdc As Long , 
ByVal IpStr As String , ByVal nCount As Long , IpRect As RECT，ByVal wFormat As 
Long ) As Long 

•hdc デバイスコンテキストを識別する。 

• IpszStr 描_する文字列を指すポインタである。 cchStr ， 《ラメータが - 1のとき 

は、 NULL で終わる文字列を指定する。 

• cchStr 文字列の文字数を指定する。 cchStr パラメータが -1 のときは、 IpszStr パ 

ラメータが NULL で終わる文字列へのボインタであると解釈され、 
DrawText 関数が自動的に文字数を計算する。 

• Iprc 迸式化されたテキストを表示する長:方形を含む RECT 構造体へのボイ 

ンタである。 

• wFormat テキストの害式を指定する。このパラメータは次の綃の組み合わせに 

なる。 



总味 

DT 一 BOTTOM 

テキストを T •端揃えにする。この fcrt : は、 DT _ SINGLEL 1 NE と紐 
み合わせて指定する。 

DT 一 CALCRECT 

及方形の幅と W さを決める。构数行のテキストがあるとき、 
DrawText 閲数は/ prr パラメータが衍す方形の幅を使い、テキ 
ストの於卜行が収まるように敁方形の底辺を広げる。蝌一行だ 
けのテキストに対しては兑力•形の右側の辺を,脚粮して、行末の 
文字が於方形の右側に接するようにする。どちらの叫介も、 
DrawText 関数は, 1 }式化されたテキストの! fS さを返すが、テキス 
卜の描_は行わない。 

DT 一 CENTER 

テキストを水平方向中央に揃える。 

DT.EXPANDTABS 

タブ文字を展開する。デフォルトのタブ,设定は8文字である。 

DT.EXTERNALLEADING 

行の! T 5 さにフォントの外部リーディングを; JH える。迪常、この 
リーディングはテキスト行の! CS さに含まれていない。 
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DT.LEFT 

DT_NOCUP 

DT.NOPREFIX 


DT.RIGHT 

DT.SINGLELINE 

DT 一 TABSTOP 


テキストを左揃えにする。 

クリッビングを行わずに描 W する。 DrawTextra 数は、 
DT _ NOCLIP を使⑴したときのほうが多少速く勅作する。 

プリ フィックスの 処理を行なわない。通常、 DrawText 開数は、 
ニーモニック プリ フィックス 「&J を、その次にくる文字にア 
ンダスコア 「 J を付けて表示する疑似命令であると解釈し、 
「&&」を 1 つのとして表ボする。 DT_NOPREFIX を指:セ 
するとこの処«!が行われなくなる。 

テキストを右揃えにする。 

テキストを小行だけで衣ポする。キャリッジリターンやライ 
ンフィードによってもこの行は分; 1 W されない。 

タブストップを,设定する。 


DT 一 TOP 


テキストを I •.端揃えにする(蝌一行のときのみ“効)。 


DT.VCENTER テキストを力•向中央揃えにします(啉一行のときのみ“効)。 


DT.WORDBRHAK 


ヮード ブレーク 文字を指定する。が/尸 re パラメータにより 
指定された長方形の端を越えてしまうときには、自動的に単想 
問で行が分; 1 PJ される。キャリッジリターンとラインフィードの 
組み合わせによっても行が分剤される。 


民り値 正常終了 「テキストの高さ 

解説 指定された设方形の領域に幣形したテキストを描画する。この閲数は、指定された 

方法(タブの展開、文字の位蹬合わせ、行の折り返しなどパこしたがってテキストを整 
形する機能がある。 - 

DrawText 関数は、デバイスコンテキストで迸択されたフォント、テキストの色、お 
よび ff 设色を使ってテキストを描画する。 

参 照 GrayString ’ TabbedTextOut ，— TextOut ,— RECT 
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GetAspectRatiohilterEx [ gdi 32 .dii [ 95 | nt 

現在のアスぺクト比フイルタを取得 


V C 

V B 

パラメータ 

戻り値 

解説 
参 照 


BOOL GetAspectRatioFilterEx ( 
HDC hdc \ 

LPSIZE IpAspectRatio 

)； 


// デバイスコンテキス トを識別す るハンドル 
//アスぺクト 比 フィルタを 識別す る SIZE 構造体へ 
のポインタ 


Declare Function GetAspectRatioFilterEx Lib M gdi 32 ff Alias " GetAspectRatioFilterEx ” 
(ByVal hdc As Long，IpAspectRatio As SIZE ) As Long 

- hdc デバイスコンテキス トを識別する ハンドル 0 

• IpAspectRatio アスぺク ト比 フィルタを 識別する SIZE 構造体への ポインタ。 


正常終了 TRUE 

輿常終 T FALSE 

拡張エラ—情報は GetLastError 閲数で取得。 

アスぺクト比とは指定されたデバイスの縦横比をボすものである。 
SetMapperFlags ，— SIZE 
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V C int GetFontData ( 

HDC hdc \ // デバイスコンテキストを 識別 

DWORD dwTable ， // メトリック テ ー ブルの 名称を指定 

DWORD dwOffset 、 //テーブルの 先頭 からのオフセット 位趵 

LPVOID IpvBuffer ， //フォントを受け场(るバッファへのポインタ 

DWORD cbData // 取得する怡報の M さを バイトで 指定 

)； 

V B Declare Function GetFontData Lib M gdi 32 M Alias ’ GetFontDataA " (ByVal hdc As Long ， 

ByVal dwTable As Long , ByVal dwOffset As Long , IpvBuffer As Any，ByVal cbData 
As Long ) As Long 

パラメータ .hdc デバイスコンテキストを識別するハンドル。 

• dwTable メトリックテーブルの名前を指定。このパラメータには、 TrueType フ 

ォン ト ファイル 仕様赉 の 中で解説され ている、メ トリ ックテーブルの 
1 つを 指定できる。 パラメータが0のとき は、 フォン ト ファイルの 先頭 
から 怡報が取得され る。 

• dwOffset 怡報の取 fU を開始する、 テープルの 先姐 からのオフセット 位丨7(を衍定 0 

このパラメータが0のとき は、 パラメータで 指定され たテープ 
ルの 先頭から M 報が取得される。 パラメータの 値が テーブルのサイズ 
を超えた場合には、 GetFontData は 0 を返す。 

• IpBuffer フォン ト愔報を受け取る バッファへのポインタ。この 値が NULL のと 

きは、 心7^レパラメータで 指定された フォントデータを 格納するため 
に必要なバッファのサイズを返す。 

- cbData 取■る怡報の M さをバイト爭位で指定。このパラメータが0のとき、 

GetFon〖Datal 対数は rfuTV/We パラメータで指定されたデータのサイズを 
返す。 

戻り値 


解脱 アプリケーションは、 GetFontData 関数を使用して TrueType フォントを文 i 1 ? とともに保 

存できる。これを行うためにフォントが埋め込み可能かどうかを判断してから 
dwOffset 、 chDatciCD 各パラメ ー タに〇を指定して全フォントフアイルを取得する。 



TrueType フォントファイルかり、フオン 


トリックデータを取得 


GetFontData 


gdi 32 .dll 


95 


NT 


GDK V 公 —715 
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TOUTLINETEXTMETRIC 構造体の otmfsType メンバをチェックすることで、フォン 
卜が埋め込み坷能かどうかを判断できる。 otmfsType のビット1がセットされている 
ときには、フォントの埋め込みができない。ビット1をクリアすることでフォントが 
埋め込み uj 能になる。ビット2をセットすると、フォントの埋め込みが読み取り# 
诚性になる。アプリケーションがこの間数を使用して TrueType 以外のフォントの怡 
報を取得しようとした埸合、 GetFomData 関数は-1を返す 0 


参 照 GetOutlineTextMetrics 


PolyTextOut 

gdi 32 .dll 

■ 

NT 

複数の文字列を表示 


V C BOOL PolyTextOut ( 

HDC hdc \ // デバイスコンテキストを識別するハンドル 

CONST POLYTEXT * pptxt ， //文字列だ列を識別する POLYTEXT 構造体 

への ポインタ 

int cStrings II pptxt パ ラ メータ に指定された POLYTEXT 

構造体の数 

)； 


V B Declare Function PolyTextOut Lib " gdi 32" Alias " PolyTextOutA " (ByVal hdc As Long ， 

pptxt As POLYTEXT，cStrings As Long ) As Long 


パラメータ 

•hdc 

デバイス コンテ キストを識別する ハン ドルを指定する。 


• pptxt 

文字列を記述している POLYTEXT 構造体の配列へのポインタ。 fti ! 
列は、1つの文字列ごとに丨つの構造体を含んでいる。 


• cStnngs 

pptxt パラ メータに指定された POLYTEXT 構造体の数を指定する。 

戻り値 

正帘終了 

TRUE 


輿帘終了 

FALSE 


拡張エラー怙報は GetLastError 閲数で取得する。 

解説 個々の POLYTEXT 構造体は、テキストを位! i v (合わせするために Windows が用いる参 

照ポイントの座標を含んでいる。アプリケーションは、参照ポイントがどのように使 
われて、 SetTextAlign _ 数を呼ぶかを指定できる。アプリケーションは、指定された 
デバイスコンテキストのために、 GetTextAlign 機能を呼んで設定する現在のテキスト 
を決定できる。蝌ーテキストを表示するためには、 ExtTextOutIJy 数を呼ぶべきである。 

参 照 ExtTextOm，—GetText Align ，— POLYTEXT ，— SetText Align 
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UINT SetTextAIign ( 
HDC hdc ， 
UINT fMode 
)； 


// デバイスコンテキストを識別するハンドル 

//配置フラグ 


V B 


Declare Function SetTextAlign Lib " gdi 32" Alias " SetTextAlign " (ByVal hdc As Long , 
ByVal wFlags As Long ) As Long 


/ マラメータ 


hdc 

fMode 


デバイスコンテキス トを識別する ハンドル。 

次の侦のいずれかを指定してテキストのだ竹を指定する。水平、垂 
iA : 方昀に関する指定を1 つ、さらにカレントポジションを変更する 
2 つのフラグから1つを迸択する。 


TA_BASELINE 
TA.BOTTOM 
TA TOP 


TA CENTER 


TA_LEFT 

TA_RIGHT 

TA NOUPDATECP 


TA RT し READING 


TA UPDATECP 


总味 

参照ポイントはテキストのベースラインにある。 

参照ボイントは 隣接 从方形の收辺にある。 

参! K ! ボイントは隣接及ゾ/形の-•济 I •.の辺にあ 
る。 

参照ボイントは 隣接 及方形の水平中央に位 ! H 
0わせされる。 

参照ボイントは 隣接 以ガ形の/ I :•辺にある。 

参照ポイントは 隣接 方形の右辺にある。 

カレントポジションは ( W 々のテキスト出力関数 
の呼び出しの後に更新されない。参照ポイント 
はテキスト出力問数に渡される。 

Windows 95 :テキストはむから左に流される。 
これは、迸〖ざれたフォントがへブライもしくは 
アラビア猫のときにだけ適される。 

カレントポジションは ( W 々のテキスト出力関数 
の呼び出しの後に史新される。カレントポジシ 
ョンは参照ポイントとして使われる。 


現在のフォントが浼字の場合には、 TA _ BASEL 1 NE と TA_CENTER 
の代わりに次の値を指定する。 


VTA_BASEUNE 
VTA CENTER 


总味_ 

参照ポイントはテキストのベースラインにある。 

参照ボイントは隣接良方形の垂直中央に位 ! S 
合わせされる。 


デフオルトの値は TA LEFTTA TOP,TA NOUPDATECP である 


文字列をテバイスに配置する 


SetTextAli 


gdi 32 .dll 


NT 


95 


GDK V 公 —7 H5 
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戻り値 

正 S 終 f 

以前のテキスト配餿設定 


異常終了 

GDI.ERROR 


拡張エラー怡報は GetLastError 閲数で取得する 0 

解説 TextOiu と ExtTextOutl 対数は、表示または他の機器と同時にテキストの文字列を配腾 

するために、テキスト整列フラグを使う。フラグは、参照ポイントとテキストと接し 
ている及方形の問の I 対係を指定する。参照ポイントは、テキスト出力阒数に渡され 
たカレントポジションまたはポイントである。 

參 照 ExtTextOut,—^TextOut 


SetTextColor 

gdi 32 .dll 

95 

NT 

テキスト色を設定する 


V C COLORREF SetTextColor ( 

HDC hdc , // デバイスコンテキストを識別するハンドル 

COLORREF crColor //テキストので 


V B Declare Function SetTextColor Lib n gdi 32" Alias " SetTextColor ” (ByVal hdc As Long ， 

ByVal crColor As Long ) As Long 


パラメータ 

• hdc 

デバイスコンテキストを識別するハンドル。 


• crColor 

テキストの色を指定する。 

戻り値 

正常終了 

以前のテキストの色 


輿帒終 r 

CLRJNVALID 


拡張エラー怡報は GetLastError 間数で取得。 

解説 デバイスが指定された色を表示できない坳合には、その色に M も近い色がテキストの 

色として•没定される。文字の竹说色は SetBkColor 関数を使用して指定する。 

参 照 - ♦ BitBlt ， ExtTextOut ，— RGB ， SetBkColor ，— StretchBlt，—TextOut 
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TextOut 

gdi 32 .dll 

95 

NT 

現在のフォントを使用して、文字列を書き込む 


V C 


V B 


パラメータ 


戻り値 


解説 


参 照 


BOOL TextOut ( 


HDC 

hdc \ 

" デバイスコンテキストを識別するハンドル 

int 

nXStart , 

//文字列を開始する論理 X 座標 

int 

n YStart y 

//文字列を開始する論理 y 座標 

し PCTSTR 

IpString ， 

//描1由 i するテキストを格納した文字列へのポインタ 

int 

cbString 

//描_する文字列のバイト数 


)； 

Declare Function TextOut Lib " gdi 32" Alias " TextOutA " (ByVal hdc As Long，ByVal x 
As Long，ByVal y As Long , ByVal IpString As String，ByVal nCount As Long ) As 


Long 


• hdc 

デバイスコンテキストを識別するハンドル。 

• nXStart 

文字列を開始する論理 X 座標を指定する。 

• nYStart 

文字列を開始する論理 y 座標を指定する。 

• IpString 

描№1するテキストを格納した文字列へのボインタを衍定する。このパ 
ラメータで指定される文字列には全角文字を含めることが" J 能。 

• cbStnng 

描_する文字列のバイト数を指定する。 

正常終了 

TRUE 

異常終了 

FALSE 


拡张エラー怡報は GetLastError 関数で取以。 

描_される文字の原点は、文字セルのノ r : 上隅になる。デフォルトでは TextOutl 对数に 
より現在の位蹬が使われたり史新されたりすることはない。アプリケーションで 
TextOut 間数を呼び出したときにカレントポジションを史新しなければならな t 、場合 
には、 Fto 供パラメータを TAJUPDATECP にセットして SetTextAlign I 対数を呼び出 
す 0 Windows はこのフラグがセットされると以後の TextOut №1数呼び出しで、 nXStart . 
/ iKS 如 r / パラメータを無祝して、カレントポジションを参照する。 

GetTextAlign , SetTextAlicn,TabbedTextOut 
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Metafile 



CreateEnhMetaFile 

gdi32.dll 

95 

NT 

拡張メタファイルを作成 


V c 


V B 


パラメータ 


戻り値 


解説 

参 照 


HDC CreateEnhMetaFile( 

HDC lukRef 、 //参照するデバイスコンテキストを識別するハ 

ンドル 

LPCTSTR IpFilename. //ファイルのを格納した文字列へのポインタ 

CONST RECT *lpRect, // 隣接敁方形を識別する RECT 構造体へのポイン 

夕 

LPCTSTR IpDeschption "任立の妃述义字列へのポインタ 

)； 

Declare Function CreateEnhMetaFile Lib "gdi32" Alias "CreateEnhMetaFileA" (ByVal 
hdcRef As Long，ByVal IpFileName As String，IpRect As RECT, ByVal IpDescription 
As String) As Long 


• hdcRef 

• IpFilename 


• IpRect 

• IpDescription 


松張メタファイルの参照テ V くイスコンテキストを識別するハンドル。 
拡張メタファイルが作成するファイル名へのポインタ。このパラメ 
ータが NULL のときは、拡張メタファイルはメモリ上に作成され、 
DeleteEnhMetaFile 閲数を使って削除されるときは、その内容が 
火われる。 

松张メタファイルに保 # されるグラフイックの寸法 (0.01 ミリメー 
トル爭位）を指定する RECT 構造体へのポインタ。 

作成した拡張メタファイルのタイトル名を指定する文字列へのポ 
インタ 0 


正常終了 拡張メタファイルのためのデバイスコンテキストを識別するハンドル 

異常終 T NULL 

CreateEnhMetaFile 関数は拡張メタファイルフォーマットのデバイスコンテキストを生 
成する。作成されたデバイスコンテキストはデバイスに依存しない形式のグラフィッ 
クとして利用可能である。 


CloseEnhMetaFile,DeIetcEnhMetaFile,GetEnhMetaFileDescription, 

GetEnhMetaFileHeader,GetWinMetaFileBits,PlayEnhMetaFile,-*RECT 
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CreateMetaFile 

gdi32.dll 

95 

NT 

メタファイルのデバイスコンテキストを作成 


V C HDC CreateMetaFile( 

LPCSTR IpszFile // 作成す るメタファイルの MS-DOS ファイル名 


V B Declare Function CreateMetaFile Lib M gdi32” Alias "CreateMetaFileA" (ByVal IpString 

As String) As Long 


パラメータ 

• Ipsztile 

作成するメタファイルに R ける MS-DOS のファイル名を指定する 
NULL で終わる文字列を指すポインタである。このパラメータが 
NULL のときには、メモリメタファイル用のデバイスコンテキストを 
返す。この文字列には、全角文字を含めることが可能である。 

戻り値 

正笊終了 
與帒終了 

デバイ スコンテキストのハンドル 

NULL 


解説 Windows 形式 メタファイルのデバイスコンテキス トを作成す る。 

Win32 アプリケーションについては、 CreateEnhMetaFilel 対数を使 Ffl するのが望まし 
い 0 

^ 照 CloseMetaFile ， DeleteMetaFile ， GetTextColor ， PolvBezier，—SelectClipRgn 


GD 一入 v s^ — 7 h a >4 
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GetEnhMetaFile 

user32.dll 

95 

NT 

拡張メタフつ 

p イルハンドルの取得 | 


V C 


HENHMETAFILE GetEnhMetaFile( 

LPCTSTR IpszMetaFile // メタファイルを格納したファイル名を示す文 

字列へのポインタ 


)； 


V B Declare Function GetEnhMetaFile Lib "gdi32 , ' Alias ” GetEnhMetaFileA" (ByVal 

IpszMetaFile As String) As Long 


パラメータ • IpszMetaFile 拡張メタフアイルを格納したフアイルの名称を格納した 

NULL で終わる文字列へのボインタ。 


戻り値 

正常終了 

拡張メタフアイルのハンドル 


異常終了 

NULL 


解説 拡張メタファイルハンドルが不要になった場合には、 DeleteEnhMetaFile _ 数でハン 

ドルを削除しなければならない。 GetEnhMetaFile 閲数で処理するためには、ウィンド 
ウズ型式メタファイルは、拡張メタファイル形式に変換されなければならない。ファ 
イルを変換するためには、 SetWinMetaFileBUsI 対数を使う。 

Windows 95 : 拔 ; 張メタファイルのタイトル妃述文字列の W 人 M は、 16,384 バイトで 
ある。 * 

参 照 DeleteEnhMetaFile ， —GetEnhMetaFile，SetWinMetaFileBits 
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GetMetaFile _ [gdi32.dll _[_95 上 NT I 

Windows メタファイルを作成 

V C HMETAFILE GetMetaFile( 

LPCTSTR IpszFile //メタファイルのファイル名称 

)； 

V B Declare Function GetMetaFile Lib M gdi32 n Alias ’’GetMetaFileA" (ByVal lpFileName 

As String) As Long 

パラメータ • IpszFile メタファイルを識別する NULL で終わるファイル名へのボインタ。 

戻り値 正常終了 メタファイルへのノ、ンドル 

興常終了 NULL 

参 照 DeleteMetaFile ， —GetEnhMetaFile，SetWinMetaFileBits 
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BeginPath 

gdi32.dll 

95 

NT 

バスブラケットの開始 


V C BOOL BeginPath( 

HDC hdc // デバイスコンテキストを識別するハンドル 

)； 

V B Declare Function BeginPath Lib M gdi32" Alias "BeginPath" (ByVal hdc As Long) As 

Long 


パラメータ • hck デバイスコンテキストを識別するハンドルを指定する。 


戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラー怙報は GetLastError I 対数で取得する。 

解説 アプリケーションは、パスブラケットが開いた後でパスにあるポイントを定義するた 

め、 GDI 閲数を利用可能になる。アプリケーションは、 EndPath 閲数で開いているパ 
スプラケットを m じることができる。 

デバイスコンテキストのためにアプリケーションが BeginPath 関数 を呼び出すときに 
は、 それ 以前のパスはすべて 破棄される。 

参照 -♦ EndPath ， FillPath，— PathToRegion ， SelectClipPath ， StrokeAndFillPath ， StrokePath ， 

WidenPath 
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CloseFigure 

gdi32.dll 

95 

NT 

バス中の図形を閉じる 


V C BOOL CIoseFigure( 

HEX ： hdc // デバイスコンテキストを識別するハンドル 

)； 

V B Declare Function CloseFigure Lib M gdi32" Alias 'CloseFigure’’ (ByVal hdc As Long) As 

Long 


パラメータ • hdc 閉じられるデバイスコンテキストを識別するハンドルを指定する。 


戻り値 

正铱終了 

TRUE 


輿常終了 

FALSE 


拡張エラー怙報は GetLastError 関数で取得する。 

解説 CloseFigure 関数は、図の敁初のポイントと現在のポジションを結んで図を閉じる。 

このとき、ラインジョインスタイルを使ってラインを接続する 0 CloseFigure 関数は、 
指定されたデバイスコンテキストに、開いているパスブラケットがあるときには何も 
しない。この機能を使って明示的に閉じられない限り、パスは開いている（たとえ 
現在のポイントと図の起点が同じでも、パスは開いているかもしれない)。 

参照 — BeginPath，— EndPath ， ExtCreatePen，— LineTo，— MoveTo 


EndPath 

gdi32.dll 

95 

NT 

バスブラケットの終了 


v c BOOL EndPath( 

HDC hdc // デバイスコンテキストを識別するハンドル 

)； 

• V B Declare Function EndPath Lib ”gdi32" Alias "EndPath" (ByVal hdc As Long) As Long 

パラメータ .hdc デバイスコンテキストを識別するための ハン ドルを指定する。 


戻り値 

正帘終了 

TRUE 


輿常終了 

FALSE 


拡張エラ ー 情報は GetLastError 関数で取得する。 GetLastError I 対数は次の t 、ずれかの 
コードを返す。 

ERROR_CAN_NOT 一 COMPLETE ， ERRORJNVALID_PARAMETER 
参照 —BeginPath 
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GetPath 

gdi32.dll 

95 

NT 

バス内の直線と曲線を取得 


V C 

V B 

パラメータ 


int GetPath( 
HOC 
LPPOINT 
LPBYTE 
int 
)； 


hdt\ // デバイスコンテキストを識別するハンドル 

IpPoints 、 //POINT 構造体へのポインタ 
IpTypes, // 頌点のタイプを指定する fill 列へのポインタ 

nSize //パス中の頃点の数 


Declare Function GetPath Lib "gdi32" Alias "GetPath” (ByVal hdc As Long, IpPoint As 
POINTAPI, lpTypes As Byte, ByVal nSize As Long) As Long 

•hdc デバイスコンテキストを識別するためのハンドルを指定する。 

• IpPobus ライン 末端と 曲線コントロールポイントを穴む POINT 構造体配列への 

ポインタ。 

• IpTxpes IR 点タイプが蹬かれるバイトの配列へのボインタ。次のいずれかの侦 


を指定する。 

タイプ 

意味 

PT 一 MOVETO 

… Points パラ メータが、た W 形を指定する 

PT_LINETO 

IpPobus パラ メータで衍定されるライン終端が次のラインの 
始点である 

PT 一 BEZIERTO 

IpPoinrs パラメータで 指定 される 曲線 コントロールがベジエ 
曲線を表す 


PTJJNETO 、 PT_BEZIERTO の firt: は、 M が|別じられるべきであること 
を示すために、次の値と結合できる。 


フラグ 

意味 

PT_CLOSEFIGURE 

ラインまたは曲線が引かれた後に、図が自動的に閉じら 
れることを衍定する。 M は、 W 後の PT_MOVETO 
と-•致しているボイントにラインをラインまたは曲線未 
端から引くことによって閉じられる。 


• nSize l P Pds によりさ し示された POINT 構造体 ftd 列の数を指定する。 
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2.5 GDI インターフ 


V C 

V B 

パラメータ 
戻り値 

解脱 

参 照 



■ 


■ 


パスからリージ 


PathToRe 


戻り値 


解説 


参 照 


/hS/Z£=0 以外列笮された頂点の数 
nSiZE=0 パス中の全頂点の数 

輿常終了 -1 

拡張エラー怡報は GetLastError 閲数で取得する。 GetLastError 閲数は次の t ゝずれかの 
コードを返す。 

ERROR_CAN_NOT_COMPLETE，ERROR 一 INVALID 一 PARAMETER ， 
ERROR_BUFFER_OVERFLOW 

んふ • パラメータにより識別されたデバイスコンテキストは、 m じられたパスを含む。 
パスの泊点は論理的な座標で戻される。 m 点はデバイスコンテキストのパスに保存さ 
れる。 GetPath は現在の変化の逆の手順を使ってデバイスコンテキストから取点を論 
f*l! 的な咏把に交換する。 FlattenPath 関数は、パスのすべての曲線をラインセグメント 
に変換するために GetPath の前に呼ばれる。 

— FlattenPath，— POINT，— PolyDraw.WidenPath 


ion gdi32.dll 95 NT 

ヨンを作成 _ 

HRGN PathToRegion( 

HDC hdc // デバイスコンテキストを識別するハンドル 

)； 

Declare Function PathToRegion Lib M gdi32" Alias M PathToRegion M (ByVal hdc As 
Long) As Long 

- hdc m じたパスを含むデバイスコンテキストを識別するハンドルを指定する。 

正？ R 終ド リージョンを識別するハンドル 

wmr 〇 

拡张エラー怙報は GetLastErrorl 対数で取得する。 GetLastErrorl 划数は次の t 、ずれかの 
コードを返す。 

ERROR—CAN_NOT 一 COMPLETE, ERROR JNVALID_PARAMETER ， 
ERRORJMOT 一 ENOUGH_MEMORY 

ル / c ， パラメータにより識別されたデバイスコンテキストは、 m じられたパスを含む。 
PathToRegion 開数がパスからリージョンを作成した後に、 Windows は指定されたデ 
バイスコンテキストからパスを破棄する。 

— BeginPath，— EndPath,SetPolyFillMode 


GDK V 必 17 Hi 
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Region 


FilIRgn gdi 32 dii 


指定されたリージョンをブラシパターンで塗りつぶす 



NT 


V C BOOL FillRgn( 

HDC hdc, // デバイスコンテキストを識別 

HRGN hrgrt ， //デバイス單位で指定した塗りつぶすリージヨンを識別 

HBRUSH hbr //塗りつぶしに使用するブラシを識別 

)； 


V B Declare Function FilIRgn Lib "gdi32 M Alias "FilIRgn” (ByVal hdc As Long, ByVal 

hRgn As Long, ByVal hBrush As Long) As Long 

パラメータ .hdc デバイスコンテキストを識別する 

- hrgn I 対数によって塗りつぶされるリージョンを指定する。リージョンの座 

標はデバイス座標を用いて指定する。 

•hbr リージョンの塗りつぶしに利用されるブラシを識別する。 

戻り値 正常終了 [" TRUE 

異常終了 FALSE 

^ ^ — CreateBrushlndirect,— CreateDIBPattemBrush,-* CreateHatchBrush, 

—CreatePattemBrush ， —CreateSolidBrush，—PaintRgn 
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GetRgnBox 

gdi 32 .dll 

95 

NT 

リージョンの境界長方形の座標を取得 

V C int GetRgnBox( 




HRGN hrgn, // リージョ 

ンを識別するハンドル 




LPRECT Iprc // 境界長方形の座標を受け取る RECT 構造体へのポインタ 


V B 


パラメータ 


戻り値 


参 照 


Declare Function GetRgnBox Lib "gdi32 •’ Alias "GetRgnBox M (ByVal hRgn As Long ， 
IpRect As RECT) As Long 


• hrgn リージョンを識別するためのハンドル。 

- Iprc 境界 M 方形の座標を受け取るための RECT 構造体へのボインタを指记する。 
関数が止 : 帘に終了した場合、リージョンの状態を表す以下の M が返される。 


NULLREGION 

リージョンが空 

SIMPLEREGION 

リージョンの境界が重なっていない 

COMPLEXREGION 

リージョンの境界が重なっている 


パラメータで指定されたリージョンが存在しない場合には〇が返される。 


—RECT 


PaintRan 

gdi 32 .dll 

95 

NT 

選択されているブラシパターンでリージョンを塗りつぶす 


V C BOOL PaintRgn( 

HDC hdc ， // デバイスコンテキストを識別するハンドル 

HRGN hrgn //塗りつぶされるリージョンを識別するハンドル 

)； 


V B Declare Function PaintRgn Lib M gdi32 M Alias ’PaintRgn" (ByVal hdc As Long，ByVal 

hRgn As Long) As Long 


パラメータ 

•hdc 

• hrgn 

デバイスコンテキストを識別するハンドルを指定する。 

間数によって塗りつぶされるリージョンを識別するハンドルを指定す 
る。リージョンの座標はデバイス座楞によって指定される。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 

参 照 

—FillRgn 



275 















第 2 章 Win 32 API リファレンス 


2. 6 System Service 

システムサービス 


メモリ管理をはじめ構造化例外処理などのエラーハンドリングと、スレッドや 
パイプの処理を担うシステムサービス関数群である。レジストリ操作とスレッ 
ド、デスクトップに関する操作は 32 ビットアプリケーション開発の中でも重要 
な位置をしめる部分である。 


Accessibitity 


GetSystem Metrics 


システムメトリックに関する情報を取得 


V C int GetSystemMetrics( 

int n Index 


user 32 .dll 



// 取得したいシステムメトリックを指定 


V B 


パラメータ 


Declare Function GetSystemMetrics Lib M user32 M Alias "GetSystemMctrics" (ByVal 
nlndex As Long) As Long 

• nlndex 取 ftf したいシステムメトリックを以ドの値で指定する。 


SM_CMOUSEBUTTONS 
SM_CXBORDER 
SM 一 SM 一 CYBORDER 
SM.CXCURSOR 
SM_CYCURSOR 
SM 一 CXD し GFRAME 
SM_CYDLGFRAME 
SM CXDOUB し ECLK 


SM_CYDOUB し EC し K 


SM CXFRAME 


意味 

マウスのポタン数 

サイズ変 1 i ! •できな I 、ウィンドウ枠の幅 
サイズ変史できないウィンドウ枠の！*•さ 
カーソルの*^ 

カーソルの!* rs さ 

ダイアログウィンドウスタイルのウィンドウ梓の幅 

ダイアログウィンドウスタイルのウィンドウ枠の A •さ 

ダブルクリックで最初のクリックが実行されたときの周辺の長 
方形の幅 

ダブルクリックで W 初のクリックが尖行されたときの№1辺の垃 
方形の敁さ 

サイズ変 1 Ji 枠を持つウィンドウ枠の幅 
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SM 一 CYFRAME 

SM.CXFULLSCREEN 

SM.CYFULLSCREEN 

SM.CXHSCROLL 

SM.CYHSCROLL 

SM.CXHTHUMB 

SM.CXICON 

SM_CYICON 

SM.CXICONSPACING 

SM_CYICONSPACING 

SM^CXMIN 

SM_CYMIN 

SM 一 CXMINTRACK 

SM.CYMINTRACK 

SM 一 CXSCREEN 

SM 一 CYSCREEN 

SM_CXSIZE 

SM.CYSIZE 

SM 一 CXVSCROLL 

SM 一 CYVSCROLL 

SM.CYCAPTION 

SM.CYKANJIWINDOW 

SM_CYMENU 

SM 一 CYVTHUMB 

SM_DBCSENABLED 


SM.DEBUG 


SM MENUDROPALIGNMENT 


SM_MOUSEPRESENT 


サイズ変史枠を持つウィンドウ枠の“さ 
フルスクリーンウィンドウのクライアント如域の幅 
フルスクリーンウィンドウのクライアント如域のさ 
水平スクロールバーの矢印ビットマップの幅 
水平スクロールノ く一の矢印ビット マッ ブの! fS さ 
水乎スクロールバーのスクロールボックス（つまみ） 

の幅 

アイコンの 
アイコンの岛さ 

アイコンを整列させた際に利用されるアイコン搁辺の公 
方形の fei 

アイコンを整列させた際に利川されるアイコン W 辺の U 
方形の！3さ 

ウィンドウの幅の®小值 

ウィンドウの高さの敁小 

ウィンドウのトラッキングの W 小阶 

ウィンドウのトラッキング敁さの W 小 W 

スクリーン領域の 幅 

スクリーン祯域の灯さ 

タイトルバーに含まれるビットマップの幅 

タイトルバーに含まれるビットマップの！* / S さ 

触スクロールノ、•一の矢印ビットマップの fci 

垂 iff スクロールノ《一の矢印ビットマップの“さ 

ウィンドウタイトルの灯さ 

潢字ウィンドウの紅さ 

琳一行で 榊 成されるメニューバーの“さ 

水 f •スクロールバーのスクロールボックス（つまみ）の 

a さ 

USER.EXE の现/£のバージヨンが 2 バイト义卞を Wi 川し 
ている埸合には TRUE もしくは 0 以外の说になる。それ 
以外の坳合には FALSE もしくは 0 になる 

USER.EXE の現 /K のバージヨンがデバッグハ •ー ジヨンの 
14 合には TRUE もしくは 0 以外になる。それ以外の叫作 
は FALSE もしくは 0 になる 

ポップアップメニューの位! ft, TRUE もしくは 0 以外の 
坳合にはボップアップメニューはメニューバー拟 1 1のん • 
側に揃えられる。 FALSE もしくは 0 の叫合には"に揃え 
られる 

マウスがインストールされている蚴〇は TRUE もしくは 
〇以外の W が返される0インストールされていない叫合 
には FALSE もしくは 0 である 
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SM_PENWINDOWS Microsoft Windows for Pen がインストールされている坳合には、 

TRUE もしくは 0 以外の値になる。それ以外の埸合には FALSE 
もしくは0である 

SM_SWAPBUTTON マウスの左右ボタンの機能が交換されて I 、る場合には TRUE も 

しくは 0 以外。これ以外の場合には FALSE もしくは 0 となる 

SM.CLEANBOOT Windows 95。 iE 常起動した坳合には 0。 SafeBoot モードの坳合 

には 1。 SafeBoot (ネットワーク）の場合には 2 が設定される 

SM.CMETRICS Windows 95 のシステムメトリックフラグの数 

SM_CXDRAG Windows 95 。 ドラッグ操作可能な兑方形領域の幅 

SM_CYDRAG Windows 95 。 ドラッグ操作口 I 能な方形領域の敁さ 

SM.CXEDGE Windows 95 〇 3D フレームの幅 

SM.CYEDGE Windows 95 〇 3D フレームの ifS さ 

SM_CXFIXEDFRAME Windows 95 。 サイズ161定ウィンドウ（キャプション有り）の輻 

SM.CYFIXEDFRAME Windows 95 。 サイズ阓定ウィンドウ（キャプションより）の W 

さ 

SM.CXMAXIMIZED Windows 95 〇 lii 大化ウィンドウの幅 

SM.CYMAXIMIZED Windows 95。 iii 大化ウィンドウの敁さ 

SM.CXMAXTRACK Windows 95 。 ウィンドウトラッキング幅の大 W 

SM_CYMAXTRACK Windows 95 。 ウィンドウトラッキング高さの W 人 4 ft 

SM.CXMENUCHECK Windows 95 。 標準のメニューチェック状態ビットマップの幅 

SM_CYMENUCHECK Windows 95 。 •冷 1 •の メニュー チェック状態ビッ トマ ップの從さ 

SM.CXMENUSIZE Windows 95 〇 メニューバーのボタンの幅 

SM.CYMENUSIZE Windows 95 。メニューバーのボタンの !V ?さ 

SM.CXMINIMIZED Windows 95 。 ウィンドウの幅の Jii 小 W 

SM.CYMINIMIZED Windows 95 。 ウィンドウの卨さの45小侦 

SM.CXMINSPACING Windows 95 。 アイコンを整列させた際に利用されるアイコン蝴 

辺の及方形の幅 

SM^CYMINSPACING Windows 95 。 アイコンを整列させた際に利用されるアイコン煳 

辺の M 方形の灯さ 

SM_CXSIZEFRAME Windows 95 。 サイズ変史枠を持つウィンドウ枠の幅 

SM_CYSIZEFRAME Windows 95 。 サイズ変史枠を持つウィンドウ枠の萵さ 

SM.CXSMICON Windows95 。 ウィンドウタイトルバーに表示される小さなアイ 

コンの幅 

SM_CYSMICON Windows %。 ウィンドウタイトルバーに表示される小さなアイ 

コンの 高さ 

SM_CXSMSIZE Windows 95 。 ウィンドウタイトルのボタンの幅 

SM.CYSMSIZE Windows 95 。 ウィンドウタイトルのボタンの高さ 

SM_CYSMCAPTION Windows 95 。 ウィンドウタイトルの萵さ 

SM_MIDEASTENABLED Windows 95 。 へブライ語およびアラビア語文字セットが利用可 

能な坳合には TRUE 
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意味 

ARW 一 DOWN 

上から下に整列させる 

ARW _ し EFT 

左から If に幣列させる 

ARW.RIGHT 

右からん:に整列させる 

ARW_UP 

下から上に幣列させる 


GetSysColor,SystemParametersInfo 


SM NETWORK 


SM SECURE 


SM SLOWMACHINE 


Windows 95。ネットワークがインストールされて I 、る場含には 
先頭ビットがオンになる。他のビットは将来の拡張のために予 
約されている 

Windows 95。セキュリティがかけられている場合には TRUE 、 
それ以外の場合には FALSE となる 

Windows 95。使 HI 中のコンピュータシステムのプロセッサーが 
ローエンド（奴い）の坳介には TRUE 、 それ以外の坳合には 
FALSE となる 


戻り傕 


解説 


パラメータで 要求され たシステムメ トリ ックの 値を返す。 

GetSystemMetricsIJy 数の W り M は利用している スクリーンタイ プにより変化する 0 
SM_ARR ANGE パラメータを 指定して Windows が fci 小化時の アイコンを どのよう { 
幣列するかを取得するには次の スター ト位的から 1 つを迸ぶ。 



总味 

ARW.BOTTOMLEFT 

左下を整列開始位！ 《 にする （ W 期 frt ) 

ARW.BOTTOMRIGHT 

右ドを粮列開始位こする 

ARW_HIDE 

最小化時に表示しない 

ARW_TOPLEFT 

ノ r : l •.を粮列開始位竹にする 

ARW.TOPRIGHT 

右上を整列開始位 R にする 


幣列のノ / 向については次から 1 つを迸ぶ 


,>>4sll>4ltf>4 
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LZCIose 

Iz32.dll 

95 

NT 


V C void LZClose( 

INT hFile // クローズしたいファイルのフアイルハンドルを指定 

)； 


V B Declare Sub LZClose Lib ,, lz32.dll M Alias "LZCIose" (ByVal hfFilc As Long) 

パラメータ • hFile クローズしたい任怠のファイルを指定するファイル ハン ドル。 

解説 LZClose 閲数はファイルのクローズ処理を実行する。クローズするためにパラメータ 

で渡されるファイルハンドルは LZOpenFile 閲数によってオープンされたファイルで 
なければならない。 CreateFile や OpenFile 閲数によってオープンされたファイルハン 
ドルを LZCIose 関数でクローズしようとした埸合はエラーが返される。 
COMPRESS.EXE (Microsoft ファイル圧縮ユーティリティ）で丨 F . 縮されたファイルを 
LZOpenFile 閲数を利用してオープンしていた場合には、 LZCIose 閲数を利用するこ 
とで、それまでのグローバルヒープが解放される。 

^ 照 CreateFile,— LZOpenFile，OpenFile 
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LZCopy 

Iz 32 .dll 

95 

NT 

ファイルをコピーして圧縮されていればそれを展開 


V C 


V B 

パラメータ 


戻り値 


解説 


参 照 


LONG LZCopy( 

int hJSource ， II コ ピー元フアイルのハンドル 

int hfDest // コピー先フアイルのハンドル 

)； 

Declare Function LZCopy Lib M lz32.dll M Alias "LZCopy" (ByVal hfSource As Long ， 
ByVal hfDest As Long) As Long 

• hfSource コピー元のファイルを識別するハンドル 0 

• hfSource コピー先のファイルを識別する ハン ドル。変換されるために使われ 

るクライアント領域を持つウィンドウの識別子。 


正常終了時にはフアイルサイズをバイト単位で返す。 
興常終了時には次のコードのいずれかを返す。 


LZERROR.BADINHANDLE 

LZERROR.BADOUTHANDLE 

LZERROR.GLOBALLOC 

LZERROR_GLOBLOCK 
LZERROR READ 


コピー元ファイルの ハン ドルが無効 

コピー先ファイルのハンドルが無効 

上限数を上回るファイルを既にオープンしている。 

もしくは ローカル メモリの取得に失敗した 

圧縮ファイルがロックされている 

コピー元のファイル形式が無効 


LZCopy 関数はパラメータで指定されたファイルを任总のファイルとしてコピーする。 
コピー元ファイルが Microsoft 圧縮ユーティリティによって圧縮されている埸合は、コ 
ビー操作にさきがけて解凍作業も実行する。 LZCopy のパラメータで指定するファイ 
ルハン ドルは LZInit 、 LZOpenFile 閲数で取得したファイル ハン ドルでなければならな 
い。 


CopyLZFile ， LZInit，— LZOpenFile 
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LZOpenFile iz32 . di1 95 nt 

圧縮および非圧縮のファイルをオープン 


V C int LZOpenFiIe ( 

LPTSTR IpFileName, // ファイル名を格納する文字列へのポインタ 

LPOFSTRUCT IpReOpenBuf. //オープンしたファイルにI対する M •報を受 

け取る OFSTRUCT 構造体へのポインタ 
WORD wStyle // 実行する動作 

)； 


V B 


パラメータ 


Declare Function LZOpenFile Lib " Iz 32. dll " Alias " LZOpenFileA " (ByVal IpszFilc As 
String，lpOf As OFSTRUCT , ByVal style As Long ) As Long 


IpFileName 

IpReOpetiBuf 

wStyle 


OF CANCEL 


OF CREATE 


OF 一 DELETE 
OF EXIST 


OF 一 PARSE 
OF—PROMPT 


OF 一 READ 

OF 一 READWR1TE 

OF_REOPEN 

OF SHARE DENY NONE 


オープンするファイル名が格納された文字列へのポインタ。 

ファイルをオープンするときにファイルに1划する M 報を格納す 
るための OFSTRUCT 構造体へのポインタ。 

LZOpenFile I対数の突行にともなう動作を次の値の紐み合わせで 
指定する。各スタイルはビットごとの OR 演兑子を利用して槐 
数指定が可能。 

_总味 

Win32 アプリケーションでは無祝。キャンセルボタンは 
OF.PROMPT スタイルでサボートされる 

新規 ファイルを 作成。 すでにファイルが“する 垛介 にはフ 
ァイル M が0に 切 りつめられる 

ファイルを 削除 

ファイルをオーブン後クローズする。ファイルの# / E テスト 
に利用する 

OFSTRUCT 祸造体へ怡報を格納する 

指定されたファイルが W ■つからなかった坳作にユーザーにダ 
イアログボックスを表示する。キャンセルボタンが JK 択され 
た坳合には LZOpenFile 閲数は "file not found ••エラーメッセー 
ジを返す 

•说み取り# HIW 性でファイルをオープンする 

読み^き可能な W 性でファイルをオープンする 

丹オーブンのバッファを利用してファイルをオーブンする 

NONE 他のプログラムから説み W きのアクセスが能な形式でファ 

イルをオープンする。フアイルがほかのプログラムによって 
すでに互換 W 性でオープンされている場合には LZOpenFile 
の実行は失敗する 
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OF_SHARE_DENY_READ 他のプログラ厶から説み取りアクセスが不可能な形式でファ 

イルをオープンする。ファイルがほかのプログラムによって 
すでに互換诚性もしくは説み取り W 性でオープンされている 
坳介には LZOpenFile の実行は失敗する 

OF_SHARE_DENY_WRITE 他のプログラムから, _f き込みアクセスが不可能な形式でファ 

イルをオープンする。ファイルがほかのプログラムによって 
すでに反換 W 性もしくは,* f き込み W 件でオープンされている 
場合には LZOpenFile の実行は失敗する 

OF_SHARE_EXCLUSIVE 排他诚性でファイルをオーブンする。他のプログラムからは 

ファイルアクセスはできない。自分自分を含む他のプログラ 
厶からこの诚性でファイルがオープンされている坳合には 
LZOpnFilelW 数の突行は失敗する 

OF_WRITE A き込み性でファイルをオープンする 

戻り値 正常終了 vvSo，/e パラメータが OF_READ 以外の場合にはファイルハンドル。 

wStyle パラメータに OF_READ を設定して圧縮ファイルをオープンし 
た場合には、特殊なファイルハンドルを返す。 

異常終了時には、次の戻り値のいずれかが返される。 

LZERROR.BADINHANDLE IpFileName バラ メータに無効なファイルハンドルが 

指定された。ファイルが見っからない 

LZERROR_GLOBALLOC 上限数を上回るファイルを既にオープンしている。 

もしくはローカルメモリの取得に失敗した 

解説 vvS /)* パラメータが OF_READ (もしくは OF—READ と OF _ SHARE _* の組み合わせ) 

でファイルが圧縮されている埸合には、 LZOpenFile 関数は LZInit を呼び出す。 LZInit 

はファイルの展操作に必要な初期化作業を実行する。 

参照 — LZCloseXZInitXZRead 
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Error 



Beep 

kernel 32 .dll 

95 

NT 

ビープ音を発生 


V C BOOL Becp ( 

DWORD dwFreq y // 音の剧波数をヘルツ （ Hz ) で指定 

DWORD dwDuration //音の W 生時問をミリ秒 ( ms ) で指定 
)； 

V B Declare Function Beep Lib ” kemel 32” Alias " Beep ” (ByVal dwFreq As Long , ByVal 

dwDuration As Long ) As Long 


パラメータ 


戻り値 


解説 


参 照 


• dwFreq プラツトフオー厶によって以卜の} ifi り指定を行う 0 

Windows 95 無视される。 

WindowsNT 周波数をヘルツ （ Hz ) で指定する。指定できる範 I 叫は37 

(0 x 25) から32,767 (0 x 7 FFF ) である。 


• dwDuration プラットフォー厶によって以1、の通り指定を行う 0 
Windows 95 無视される。 

WindowsNT W 生時問をミリ秒 ( ms ) で指定する。パラメータに -1 を 

指定した場合には再び Beepl 対数が呼び出されるまで Beep 
音が再生される。 


正常終了 TRUE 

異常終了 FALSE 

拡張エラー怡報は GetLastError 関数で取得。 

Windows 95の坳合には、 Beep 阅数のすべてのパラメータは無祝される。コンピュー 
夕にサウンドカードがインストールされている場合には、デフ オル トのサウンドが再 
生される。サウンドカードがインストールされていない場合には、標準のシステム 
Beep 音が鳴る 0 

WindowsNT の場合、 Beep 閲数は冉生が終 T するまでアプリケーシ3ンに制御を返さ 
ない。ただし、 Av ， Z ) Mr «// 洲パラメータに -1 が指定された坳合には、関数の実行後た 
だちに制御が戻される。 

MapWindowPoints ， POINT，ScreenToClient 
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ExitWindows 

user 32 .dll 

95 

NT 

Windows をシィ 

[^ットダウン 


V C BOOL ExitWindows ( 

DWORD dwReserved , // 予約済み 0 

UINT “Reserved // 予約済み 0 

)； 

V B Declare Function ExitWindows Lib " user 32 •’ Alias " ExitWindows " (ByVal dwReservcd 

As Long , ByVal uRetumCode As Long ) As Long 

パラメータ • dwReserved 予約済みで 0 でなければならない。 

• u Reserved P 約済みで0でなければならない。 

戻り値 

拡張エラー怡報は GetLastError 閲数で取得。 

解説 Windows 95の場合、 ExitWindows _数は呼び出し元のアプリケーションを除くすべ 

ての実行中アプリケーションに対して WM_QUERYENDSESSION メッセージを送信 
する。すべての実行中アプリケーションからシャットダウンを許可する TRUE の/人 ! り 
肮が返された場合は、シャットダウンが実行される。いずれかのアプリケーションか 
らシャットダウンを拒否する FALSE の戻り値があった場合には、シャットダウン処 
理はキャンセルされる。 

WindowsNT では、 ExitWindows 開数はすべての実行中アプリケーションに対して 
WM_QUERYENDSESSION メッセージを送信してシャットダウン処理の突行を確認 
する。 

シャットダウン処理中に Windows は新しいアプリケーションを起勤することはできな 
い0 

^ 照 Dct ' WindowProc,ExitWindowsEx 
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GetLastError 

kernel 32 .dll 

95 

NT 

拡張 エラーコードを 返す 


V C DWORD GetLastError (); 

V B Declare Function GetLastError Lib ,, kemel 32 M Alias M GetLastError M () As Long 

戻り値 敁後に呼び出された API 関数の処理中に関数が実行した SetLastErroi •関数の引数が 

最終エラーコードとして戻り値になる。 

解説 戻り値となるエラーコードは32ビット値である （31 ビット目が非常に重要な总味を表 

わす)。29ビット目はアプリケーション予約のエラーコードビットである。アプリケ 
ーションでユーザー定義のエラーコードを定義する坳合には、このビットを利用す 
る。これによって、 Windows が返す t ゝかなるエラーコードともバッティングすること 
なくエラーコードの設定が可能になる。 

参 照 SetLastError,SetLastErrorEx 
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kernel 32 .dll 

95 

NT 

ファイルを コピー 


V C 

BOOL CopyFile ( 



し PCTSTR 

IpExistingFileName, // コピー元ファイル名を格納した文'？^列へ 

のポインタ 


LPCTSTR 

lpNewFileName, //コピー先ファイル名の文7•列を格納した 

文字列へのポインタ 


BOOL 

bFaillfExists //ファイル存在時の勋作 


)； 


V B 


パラメータ 


Declare Function CopyFile Lib " kemel 32" Alias " CopyFileA ” (ByVal 
IpExistingFileName As String，ByVal lpNewFileName As String , ByVal bFaillfExists 
As Long ) As Long 

• IpExistingFileName コピー元ファイル名を格納した文ネ列へのポインタ。 

• lpNewFileName コピー先ファイル名を格納した文ネ列へのボインタ。 

• bFaillfExists lpNewFileName パ ラメータで指定されるファイルが、コピー 

先にすでに同名のファイルとして存在して t ゝた坳合の操作を 
指定する。次の値のいずれかを指定する。 



愈味 

TRUE 

FALSE 

関数は輿 « 終了し、 

関数は正常終了し、 

ファ イルのコビーは灾行されない 

ファイルは上 a きコピーされる 


戻り値 

正常終了 

TRUE 


輿常終了 

FALSE 


拡張エラー怙報は GetLastError 関数で取得。 
CreateFile ，— MoveFile 
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GetCurrentDirectory 

kernel 32 .dll 

95 

NT 

プロセスの現在のディレクトリを返す 


V C 


V B 

パラメータ 


戻り値 


参 照 


DWORD GetCurrentDirectory ( 

DWORD nBufferLength ， // ディレクトリ名を格納するバッファサイズ 

LPTSTR IpBuffer //ディレクトリ名を格^するバッファへのポインタ 

)； 

Declare Function GetCurrentDirectory Lib M kernel 32 M Alias ,, GetCurrentDirectoryA M 
(ByVal nBufferLength As Long , ByVal IpBuffer As String ) As Long 

• nBufferLength カレントディレクトリ名を 格納す るためのバッファサイズを 衍 

定する。バッファサイズはディレクトリ名の文字列の M さと終 
端の NULL 文字の合計。 

• IpBuffer カレントディレクトリ名を格納するための NULL で終わる义字 

列バッファへのボインタ〇 

正常終了 ^終端の NULL 文字を除いたカレントディレクトリ名の鉍さ 
異常終 f 0 

拡張エラ ー t / f 報は GetLastError 関数で取得。 

CreateDirectory , GetSystemDirectory ,-^ GetWmdowsDirectory , RemoveDirectory , 

SetCurrentDirectorv 
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GetDiskFreeSpace 

kernel32.dll 

95 

NT 

空きディスク容量の総量を返す 


V C 


V B 


パラメータ 


戻り値 

参 照 


BOOL GetDiskFreeSpace ( 


"ルートディレクトリ名を格納した文字 

列へのポインタ 

//クラスタあたりのセクタ数を格納する 
ノくッ ファへのポインタ 
" セクタあたりのバイト数を格納するバ 
ッファ へのポインタ 

IpNumberOfFreeClusters , //空きクラスタの数を格納するバッファ 

へのポインタ 

IpTotalNumberOfCluslers //総クラスタ数を格納するバッファへの 

ポインタ 


LPCTSTR IpRootPathName ， 


LPDWORD IpSectorsPerCluster , 


L PD WORD IpBvtesPerSector 、 


LPDWORD 


LPDWORD 


)； 


Declare Function GetDiskFreeSpace Lib ” kemel 32" Alias " GetDiskFreeSpaceA M (ByVal 
IpRootPathName As String , IpSectorsPerCluster As Long , IpBytesFerSector As Long , 
IpNumberOtPreeClusters As Long , lpTtoalNumberOfClusters As Long ) As Long 


• IpRootPathName 


• IpSectorsPerCluster 


• IpBytesPerSector 


• IpNumberOfFreeClusters 
•IpTotalNumberOfClusters 


NULL で終わるルートディレクトリ名を格納した文字 
列へのポインタ。このパラメータに NULL を指定した 
場合は、カレントディレクトリのルートディレクトリ 
が指定されるのと同一である。 

クラスタあたりのセクタ数を格納するバッファへのポ 
インタ。 

セクタあたりのバイト数を格納するバッファへのボイ 

、へ 

空きクラスタの数を格納するバッファへのポインタ。 

総クラスタ数を格納するバッファへのポインタ。 


正常終了 TRUE 

與常終了 FALSE 

招:张エラ ー M •報は GetLastErrorlJH 数で取得。 


GetDriveType 
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GetFileAttributes | kernel32.dll | 95 | NT 

フアイル属性を返す _ 

V C DWORD GetFileAttributes( 



LPCTSTR 

IpFileName // ファイルもしくはディレクトリ名を格納した文字 



列へのポインタ 

V B 

， w 

Declare Function GetFileAttributes Lib ”kemel32" Alias "GetFileAttributesA" (ByVal 
IpFileName As String) As Long 

パラメータ 

• IpFileName 

ファイル名もしくはディレクトリ名を格納した NULL で終わる文 
字列へのポインタ。 

戻り値 

正前終了 

屈性を示す次の値 


異帒終了 

OxFFFFFFFF 


拡張エラー怙報は GetLastErrorl 対数で取得。 

値 1怠味 

FILE_ATTRIBUTE_ARCHIVE ァーカイブ厲性 

FILE^ATTRIBUTE_COMPRESSED 圧縮 K 性。ファイルの坳合にはデータ全体 

が ff . 縮されていることを、ディレクトリの坳 
合には新規作成されたばかりのサブディレク 
トリであることを示している。 
FILE_ATTRIBUTE_DIRECTORY ディレクトリ 

FILE_ATTRIBUTE_HIDDEN 非表示娀性 

FILE_ATTRIBUTE_NORMAL 通常ファイル 

FILE_ATTRIBUTE_READONLY 読み込み専用 

FILE_ATTRIBUTE_SYSTEM システムファイル 

参 w DeviceIOControl,FindFirstFile,FindNextFile,SetFileAttributes 
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2.6 システムサービス 


GetFileSize 

kernel32.dll 

95 

NT 

ファイルサイズの取得 


V C 

V B 

パラメータ 


戻り値 


解説 

参 照 


DWORD GetFileSize( 

HANDLE hFile、 //サイズを取得するファイルのハンドル 

LPDWORD IpFileSizeHigh ， //ファイルサイズの上位ワードを格納する変 

数へのポインタ 

)； 

Declare Function GetFileSize Lib "kemel32 u Alias "GetFileSize'' (ByVal hFile As 
Long，IpFileSizeHigh As Long) As Long 

• hFile サイズが戻されるファイルのハンドルを指定する。ハンドルは 

GENERICLREAD または GENERIC_WRITE アクセスによって作 
成されたものでなければならない。 

• IpFileSizeHigh ファイルサイズの上位ワードが戻される変数へのボインタ。上 

位ワードを必要としない場合には、このパラメータは NULL で 
である。 


正俏終了 

與帘終 I' (IpFileSizeHigh = NULL) 

興常終 T {IpFileSizeHigh = NULL 以外 ) 


ファイルサイズの下位ワード 。 IpFileSize 
"/ • 尺 /! が NULL でない坳合には、ファイル 
サイズの上位ワードを、パラメータで示 
された変数に入れる。 

OxFFFFFFFFo 拡張エラ ー怡報は GetLast 
Error^l 数で取得する。 

OxFFFFFFFFo GetLastError I 对数は NO_ 
ERROR を返す 0 


ハレのためのファイルの補類を決定するためには、 GetFileType 閲数を使う。 
GetFileSize 問数は、ファイルの未圧縮時のサイズを取得する。ファイルの圧縮され 
たサイズを取得するには、 GetCompressedFileSizelJy 数を利 HI する。 


GetCompressedFileSize，—Get 卜 ile l’vpe 
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GetFileT 

I 


7 イル種類を取得 



V B 


パラメータ 
戻り値 


DWORD GetFileType( 
HANDLE hFile 
)； 


// フ アイ ルの ハン ドル 


Declare Function GetFileType Lib "kemel32" Alias "GetFileType" (ByVal hFile As 
Long) As Long 

• hFile ファイル柯類を利別するためのオープンされたファイルのハンドル 

反り値は次の M の t 、ずれかになる。 


FILE 一 TYPEJJNKNOWN 
FILE-TYPE 一 DISK 
FILE—TYPE-CHAR 
FILE TYPE PIPE 


意味 

不明 

ディスクファイル 

プリンタもしくはコンソール文字 

名前付きもしくは名前なしのパイプ 


GetFileSize，—GetFileTime 
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2.6 システムサービス 


GetFullPathName 

kernel 32 .dll 

95 

_ 

NT 

ファイル名のバス名を取得 


V C 


V B 


パラメータ 


戻り値 


解脱 

参 照 


DWORD GetFullPathName( 

LPCTSTR IpFileName 、 // パス名を取得したいファイル名を格納した文字列 

へのポインタ 

DWORD nBufferUnglh. /// 、。ス 名を格納するバッファサイズ 

LPTSTR IpBuffer ， //パス名を格納するバッファへのポインタ 

LPTSTR *lpFilePart //ファイル名を格納するバッファへのポインタ 


Declare Function GetFullPathName Lib M kemel32 ,f Alias "GetFullPathNameA" (ByVal 
IpFileName As String, ByVal nBufferLength As Long, ByVal lpBuffer As String, 
ByVal IpFilePart As String) As Long 


• IpFileName 

• nBufferLength 

• lpBuffer 

• IpFilePart 


パス名を取得したいファイル名を格納した NULL で終わる文字 
列へのポインタ。ファイル名は MS-DOS の 8.3 形式でも M いファ 
イル名の形式でも指定が可能。 

ドライブ名から始まるパス名を格納するバッファのサイズ 
NULL で終わるパス名を格納するバッファへのボインタを指定 
する。 

//? 仙价 r パラメータに返されるフルパスの文字列中に穴まれ 
るファイル名。 


正常終了 lpBuffer, 《ラメータに返された文字列の M さ。ただし終端の NULL 文 

字は含まれていない 
輿帘終了 0 

拡张エラー怡報は GetLastError 閲数で取得。 


GetFullPathName 関数は、指定されたファイル名にカレントドライブのドライブ名と 
カレントディレクトリ名を結合して、フルパス形式のファイル名を生成する 0 閲数の 
'JT 行によって返されるフルパス名についての幣合性、妥当性検査は行われない。 


GetShortPathName,GetTempPath,SearchPath 
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LockFile 

kernel32.dll 

95 

NT 

ファイルをロック 


V C 


V B 


パラメータ 


戻り値 

解脱 
参 照 


BOOL LockFile( 


HANDLE 

hFile ， 

DWORD 

dwFileOffsetLow, 

DWORD 

dwFileOffsetHigh, 

DWORD 

nNumberOfBytesToLockLow ， 

DWORD 

nNumberOfBytesToLockH igh 


//ロツクするフアイルのハンドル 
//ロック領域の下位ワード 
//ロック領域の上位ワード 
"ロック領域の於さの F 位ワード 
//ロック領域の於さの上位ワード 



Declare Function LockFile Lib "kemel32" Alias "LockFile" (ByVal hFile As Long ， 
ByVal dwFileOffsetLow As Long，ByVal dwFileOffsetHigh As Long，ByVal 
nNumberOfBytesToLockLow As Long，ByVal nNumberOfBytesToLockHigh As Long) 
As Long 


• hFile 

• dwFileOffsetLow 

• dwFileOffsetHigh 

• nNumberOfBytesToLockLow 

• nNumberOfBytesToLockHigh 


GENER1C_READ または GENER1C_WR1TE で作成 
されたロックするファイルを識別するハンドル。 
ロックする領域の開始位 iW (ファイルの先頭からの 
オフセット値 ) の下位ワードを指定する。 

ロックする領域の開始位打(ファイルの先頭からの 
オフセット値)の上位ワードを指定する 0 
ロックする領域の長さの下位ワードを指定する。 
ロックする領域の M さの上位ワードを指定する。 


正常終了 TRUE 

異常終厂 FALSE 

拡張エラー怙報は GetLastErrorl 対数で取得する。 


ファイル領域をロックすることで、指定された領域の占有アクセス権が得られる。ま 
たファイルの終わりを越える領域をロックしてもエラーとならない。 


CreateFile，UnlockFile 
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2.6 システムサービス 


V C 


BOOL MoveFile( 

LPCTSTR IpExistingFileName, // 柊®;するファイル名が格納された文字列へ 

のポインタ 

LPCTSTR IpNewFileName // 移®先の怡報が格納された文字列へのポイ 

ンタ 


V B 


ノマラメータ 


戻り \1 


解説 


Declare Function MoveFile Lib M kemel32 M Alias "MoveFileA” (ByVal IpExisting 
FileName As String, ByVal IpNewFileName As String) As Long 


IpExistingFileName 


IpNewFileName 


柊!助するファイルが格納された NULL で終わる义字列への 
ポインタを指定する。 

移動先のファイル名やディレクトリ名を格納した NULL で終 
わる文字列へのポインタを指定する。ここで指定するファイ 
ル名やディレクトリ名がすでに存在してはならない。 


正帒終了 TRUE 

輿常終了 FALSE 

拡張エラー怡報は GetLastError 閲数で取从 


FALSE 


MoveFile I 划数は、ファイルもしくはディレクトリとその卜 W に位するファイルやサ 
ブディレクトリすべてを別の坳所へ移勁する。 


CopyFile^MoveFileEx 


イル名を変更 


MoveFile 


kernel 32 .dll 


NT 


95 


,>>JHII>4ltf>4 
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ReadFile 

kernel 32 .dll 

95 

NT 

ファイルから読み取る 


V C 


V B 


パラメータ 


戻り値 


解説 

参 照 


BOOL ReadFile( 
HANDLE 
LPVOID 

DWORD 

LPDWORD 


hFile, // フアイルのハンドル 

IpBuffer ， //読み取ったデータを格納する 

ハへソフアへのポインタ 
nNumberOfBytesToRead, // 読み取る サイズ 
IpNumberOfBytesRead, "fr!i み 取りを I 识始 する 位 i _ v ( への 

ポインタ 


LPOVERLAPPED IpOverlapped //OVERLAPPED 構造体へのポイ 

ンタ 


)； 


Declare Function ReadFile Lib "kemel32" Alias M ReadFile" (ByVal hFile As Long ， 
lpBuffer As Any, ByVal nNumberOtBytcsToRead As Long, IpNumberOfBytesRead As 
Long，IpOverlapped As OVERLAPPED) As Long 


• hFile 

• lpBuffer 

• nNumberOfBytesToRead 

• IpNumberOfBytesRead 

• IpOverlapped 


説み取りを開始するファイルのハンドルを指定する 0 
ファイルから説み取った怡報を格納するためのバッファ 
へのポインタを指定する。 

ファイルから説み取るデータのサイズを指定する。 

ファイルから説み取りを開始するバイト位 ! ft : を示すポ 
インタを指定する。 

OVERLAPPED 祸造体へのボインタ。 hFile が HLE 一 
FLAG^OVERLAPPED によって作成されて t 、る坳作に 
は、この構造体が必费である。 


正常終了 TRUE 

與常終了 FALSE 

拡張エラー怙報は GetLastErrorl 划数で取得する。 

フアイルの一部が別のプロセスによってロックされ、ロックされた部分と読み出し要 
求部分が ■[ 掏している坳合、関数は失敗する。 

CreateFile ， GetCommTimeouts ， GetOverlappedResult ， —OVERLAPPED ， 

—PeekNamedPipe ， ReadFileEx ， SetCommTimeouts,WrUeFile 
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2.6 システムサービス 


RemoveDirectory 

kernel 32 .dll 

95 

NT 

既存のディレクトリを削除 


V C 


V B 

パラメータ 

戻り値 


参 照 


BOOL RemoveDirectory( 

LPCTSTR IpPathName //ディレクトリを識別するパス名へのポインタ 
)； 

Declare Function RemoveDirectory Lib M kemel32 M Alias 'RemoveDirectoryA" (ByVal 
IpPathName As String) As Long 


• IpPathName 削除するディレクトリを識別する NULL で終わる文字列へのポ 



ィンタを指定する。 

正常終了 

TRUE 

異常終了 

FALSE 


拡張エラー怡報は GetLastErrorlW 数で取份〇 
CreateDircctorv 
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Help 


GetMenuContextHel 


ニューコンテキストヘルプ ID を取得 



user 32 .dll 




V C DWORD GetMenuContextHelpId( 

HMENU hmenu // ヘルプコンテキスト ID を取得するメニューのハンドル 

)； 


V B Declare Function GetMenuContextHelpId Lib ”user32” Alias "GetMenuContextHelpId” 

(ByVal hMenu As Long) As Long 

パラメータ • hmenu ヘルプコンテキス ト ID を 取得す るメニューのハンドルを 指定す る 0 

戻り 値 メニュー 項目が#在する埸合には コンテキス トヘルプ ID を返す。 


Get Wi ndowContextHel 


ウィンドウコンテキストヘルプ ID を取得 


user 32 .dll 



■ 


V C DWORD GetWindowContextHelpId( 

HWND hwnd // ヘルプコンテキスト ID を取泔するウインドウのハンドル 

)； 

V B Declare Function GetWindowContextHelpId Lib U user32" Alias "GetWindowContext 

Helpld" (ByVal hWnd As Long) As Long 

パラメータ • hmenu ヘルプコンテキスト ID を 取得す るウインドウのハンドルを 指定す る 0 

戻り 値 ウィンドウが 存在す る 場合には コンテキストヘルプ ID を 返す。 


ンを起動し、 

v c BOOL WinHelp( 

HWND hWndMain. // ヘルプを贺求するウィンドウを識別するハンドル 
LPCTSTR IpszHelp. // ヘルプに表示させるヘルプファイル名を格納する 

NULL で終わる文字列へのポインタ 
UINT uCommand, // 要求するへルプの袖類 
DWORD dwData //追加データ 
)； 


user 32 .dll 95 NT 

ンテキスト情報やトピック情報を渡す 


WinHelp 

Windows ヘルプアブリケーシ三 
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2.6 システムサービス 


V B 


パラメータ 


戻り値 


解説 


Declare Function WinHelp Lib M user32 M Alias M WinHelpA M (ByVal hwnd As Long, 
ByVal lpHelpFile As String, ByVal wCommand As Long, ByVal dwData As Long) As 
Long 


• hWndMain 

• IpszHelp 


• uCommand 

• dwData 


ヘルプを要求したウィンドウを識別するハンドル。 WinHelp 関数は 
この パラメータを 利用してアプリケーションを管理する。 

ヘルプに 表示させる ヘルプファイルのファイル 名とディレクト リパ 
スを格納した NULL で終わる文字列へのボインタを指定する。へ 
ルプ トピックを 1 次ウィンドウではなく 2 次ウィンドウに表示させ 
る埸合には、 ファイル 名の後に不等号 （ >) と 2 次ウィンドウの名前 
を指定する。 2 次ウィンドウの名前は、 ヘルププロ ジヱクトフ ァイ 
ル （ .HPJ) の [WINDOWS ] セクションであらかじめ定義しておかな 
ければならない。 

费求するヘルプの W1 類を指定する。指定できる値の一 1 ^と 
パラメータの 値の意味に つ t 、ては 解説を参照。 

追加データを指定する。利用可能な値は wCV ノ mmam/ パラメータの 
値により異なる。 


正常終了 TRUE 

異常終了 FALSE 

メニュー項 El が存在する場合にはコンテキストヘルプ ID を返す。 

要求したヘルプのウインドウをクローズする前にアプリケーショ ンは i4Co ， _m / に 
HELP.QUIT を指定して WinHelp を呼び出さなければならない。すべてのアプリケー 
シヨンがこの ® J 作を実行するまで Windows ヘルプは終了しない。 


uummwna 

動作 

dwData 

HELP 一 COMMAND 

ヘルプマクロを実行 

実行するヘルプマクロ 
を表す文字列へのボイ 

ンタ 

HELP 一 CONTENTS 

•HPJ ファイルの [OPTIONS] セクシ | 
ョン内の CONTENTS オプション 
で定義されたヘルプの目次トピッ 
クを表示 

無祝される。 0 に設定 

HELP 一 CONTEXT 

.HPJ ファイルの |MAPj セクション 
で定義されたコンテキスト番号が 
識別する特定のヘルプトピックを 
表示 

トピックのコンテキス 
卜番号を表す符号なし 
整数 

HELP.CONTEXTPOP 

•HPJ ファイルの [MAP 】 セクシヨン 

トピックのコンテキス 

UP 

で定義されたコンテキスト番号が 
識別する特定のヘルプトピックを 
ポップアップウィンドウに表示 

卜番号を表す符号なし 
整数 
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HELP FORCEFILE 


HELP 一 HELPONHE し P 
HELPJNDEX 
HELP—KEY 

HELP—MULTIKEY 

HELP.PARTIALKEY 


HE し P 一 QUIT 

HELP 一 SETCONTENTS 


WinHelp 関数が正しいヘルプファ 
イルを表示していることを保証す 
る。現在正しいヘルプファイルが 
表示されている埸合には何も実行 
されない0間違ったヘルプファイ 
ルが表示されている坳合には 
WinHelp 関数は正しいファイルを 
オープン 

[ヘルプの 使い方]ファイルを示 
す目次トピックを表示 
ヘルプ トピックの検索ダイアログ 
に目次を表示 

dn Data パラメータ に渡されるキー 
ワードと正確に一致するキーワー 
ドがリスト内に1つある坳合にそ 
のトピックを表示 
代替キーワードテーブル内のキー 
ワードが識別するヘルプトピック 
を表示 

dwData パラメータに渡されるキー 
ワードと正確に一致するキーワー 
ドがリスト内に1つある場合には 
そのトピックを表示。一致するキ 
ーワードが複数ある場合には[卜 
ピックの検索]ダイアログボック 
スを表示して[ジャンプ]リスト 
ボックスの中にトピックをリスト 
表示。一致するキーワードがない 
場合には[トピックで検索]ダイ 
アログボックスを表示 
ヘルプが不费になったことを 
Windows ヘルプに知らせる。ほか 
のアプリ ケー ションがヘルプを要 
求して lr 、な I 、場合には Windows へ 
ルプが クローズ 

ユーザーが F 1 キーをしたときに 
ヘルプに表示させる目次トピック 
を決定 


無祝される。0に設定 


無祝される。0に設定 

無祝される。0に設定 

トピックのキーワード 
を表す文字列へのボイ 
ンタ 

MULTIKEYHELP 構造 

体へのボインタ 

トピックのキーワード 
を表す文字列へのボイ 

ンタ 


無視される。0に設定 


アプリケーシヨンで目 
次トピックとして表示 
させたいトピックのコ 
ンテキスト番号を表す 
符号なし整数 
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2.6 システムサービス 


HELP - SET 1 NDEX 
HELP 一 SETW 1 NP 0 S 


指定されたトピックを目次に設定 
表示する 

ヘルプウィンドウがアイコン化さ 
れていたりメモリ内にある場合に 
ウィンドウを表示して渡されたデ 
ータに基づいてウィンドウの位 ; K 


目次トピックを表す文 
字列へのポインタ 

HELPWIN 1 NFO 構造 

体へのポインタ 


を調整する 


参照 — HELPWIN 1 NFO ，— MULTIKEYHELP 



GlobalAlloc 

kernel 32 .dll 

95 

NT 

グローバルヒープからメモリを割り当てる 


V C HGLOBAL GlobalAUoc ( 

UINT “ Flags ， // メモリを割り当てる方法 
DWORD dwBytes //割り当てられるバイト数 
)； 

V B Declare Function GlobalAlloc Lib ” kemel 32" Alias " GlobalAlloc " (ByVal wFlags As 

Long，ByVal dwBytes As Long ) As Long 

パラメータ • uFlags メモリを割り当てる方法を次ので指定する。 



意味 

GMEM.FIXED 

固定メモリを剤り当てる。 GMEM_FIXED と 


GMEMJVIOVEABLE は同時には指定できなぃ 

GMEM.MOVEABLE 

移勁可能メモリを削り当てる。 GMEM_FIXED と 


GMEM.MOVEABLE は M 時に指定できなぃ 

GPTR 

GMEM_FIXED と GMEM_ZER0IN1T の紐み合わせ 

GHND 

GMEM_MOVEABLE と GMEMJZEROINIT の紐み合わせ 

GMEM.DDESHARE 

共打可能メモリを; W り肖てる。ダイナミックデータ交換 


(DDE) だけに使われ、 GEM_SHARE と等価 

GMEM_DISCARDABLE 

说褒■可能メモリを; 1 (U り 、 1 1 てる0必ず GMEM_MOVEABLE とと 


もに使用する 

GMEM 一 LOWER 

無視される。 Windows 3. x との互換性のために残されてぃる 

GMEM_NOCOMPACT 

別り当て獎求に対してメモリのコンパクションや廃焚を行わな 

い 

GMEM_NODISCARD 

削り当て要求に対してメモリの廃焚を行わなぃ 
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戻り値 


解説 


参 照 


GMEM.NOT^BANKED 
GMEM.NOTIFY 
GMEM 一 SHARE 

GMEM ZEROINIT 


無視される。 Windows 3. x との互換性のために残されている 

無祝される。 Windows 3. x との互換性のために残されている 

ほかのアプリケーションと共有できるメモリを剤り当てる。 
GMEM_DDESHARE と等価 

メモリ 内容を0 に 初期化 


• dwBytes 別り当てるメモリのバイト数を指定する。 

•r 


正常終了 割り当てられたメモリオブジェクトのハンドル 

異常終了 NULL 

拡張エラー怡報は GetLastError 関数で取得。 

アプリケーションで GlobalAlloc 関数により返されたハンドルをボインタに変換する 
には、 GlobalLock 開数を使わなければならない。 

関数が正常に終了した埸合は、少なくとも趙求された M 大锨を剂り当てる。削り当 
てられたメモリの W 大 W が要求された U よりも多くなった場合、アプリケーションは 
そのメモリをすベて使用できる。グローバルメモリオブジェクトのサイズを決めるに 
は、アプリケーションで GlobalSize 関数を使用する。 

グローバル メモリオブジェクトを解除するには、 GlobalFree 閲数を使わなければなら 
ない。沏り当てられたメモリオブジヱクトのサイズや铋性を変史する坳合には、 
GlobalReAlloc 閲数を使うことで実現できる。 


GlobalFree , GIobalLock , GlobalReAlloc , GlobalSize ,-^ Local Alloc 


HeapAlloc 

kernel 32 .dll 

95 

NT 

ヒープからメモリを割り当てる 


V C LPVOID HeapAlloc ( 

HANDLE hHeap ， // ヒープブロックを•裁別するハンドル 
DWORD dwFlags ， //メモリの剖り当て方法 
DWORD dwBytes //割り当てるメモリのサイズ 
)； 

V B Declare Function HeapAlloc Lib " kemel 32” Alias " HeapAlloc " (ByVal hHeap As Long , 

ByVal dwFlags As Long，ByVal dwBytes As Long ) As Long 

パラメータ • hHeap メモリが;明り当てられるヒープブロックを識別する ハンドル を指定す 

る。パラメータは、 HeapCreate または GetProcessHeapliy 数で戻された 
ハンドルである。 

• dwFlags メモリを割り当てる方法を指定する。次の値の t ゝずれかを指定する。 


姑. 

意味 

HEAP_GENERATE_EXCEPTIONS 

HEAP_NO_SERIALIZE 

明数が火敗した坳合に OS が例外を返す。 

|划数がヒープブロックにアクセスする際に排他的な 
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アクセスを実行しない。 

HEAP_ZERO_MEMORY 削り当てられるメモリは 0 で初期化される0 

• dwBytes 割り当てられるメモリのサイズを指定する。 


戻り値 


解脱 


参 照 


正常終了 割り当てられたメモリブロックへのポインタ 

異常終了 NULL 

HEAP _ GENERATE _ EXCEPT 10 NS フラグが指定され、関数が輿終 T した埸合に 
は、次の例外が返される。 


STATUS _ NO_MEMORY 要求された サイズのメモリ を削り当てることが 

できない。 

STATUS _ ACCESS_VIOLATION 指定されたノゝ 。ラ メータが正しくない。 

HeapAllocI 対数が正常に終了した場合、少なくとも要求されたメモリのサイズが;切り 
当てられる。削り当てられたブロックの実除のサイズを確認するためには 、 HeapSize 
関数を使う。 

割り当てられたブロックをメモリから解放するためには、 HeapFree 閲数を使う。 
HeapAlloc により割り当てられたメモリは固定である。 


GetProcessHeap ， HeapCreate ， HeapDestroy ， HeapFree ， HeapReAlloc , HeapSize , 
- ♦SetLastbrror 


LocalAlloc 

kernel 32 .dll 

95 

NT 

ローカルヒープからメモリを割り当てる 


V C HLOCAL LocaIAUoc ( 

UINT uFlags ， // メモリを沏り当てる方法 

UINT “Bytes //^ J り当てるメモリのバイト数 

)； 

V B Declare Function LocalAlloc Lib " kemel 32" Alias " LocalAlloc " (ByVal wFlags As 

Long，ByVal wBytes As Long ) As Long 

パラメータ • uFlags 次の侦の組み合わせからメモリを剂り当てる方法を指定する。 


Vi . 

意味 

LMEM.FIXED 

IA1 定メモリを沏 り 、 1 i てる。 LMEM.MOVEABLE とともに指定 


はできない 

LMEM_MOVEABLE 

移®/可能なメモリを剖り当てる。 LMEM.FIXED とともに指定 


はできない 

し PTR 

LMEM_FIXED と LMEM_ZEROINIT の組み合わせ 

LHND 

LMEM_MOVEABLE と LMEM_ZEROINIT の紐み合わせ 

NONZEROLHND . 

LMEM_MOVEABLE と等価 
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戻り値 


解説 


参 照 


NONZEROLPTR 
LMEM—DISCARDAB し E 

LMEMJMOCOMPACT 

LMEM NODISCARD 


LMEM_FIXED と等価 

廃棄巧能なメモリを剖り当てる。 LMEM_FIXED とともに指定 
はできない。 Win 32 アプリケーションではこの指定は無祝され 
る 

沏り当て®求を满たすためのメモリのコンパクションや说锯を 
行わない 

沏り，て®求を满たすためのメモリの梅免を行わない 


LMEM ZER 01 N 1 T 


メモリ内 V ?を0で初期化する 


• “Bytes 割り当てるメモリのバイト数を指定する。 

正常終 f |"剤り当てられたメモリオブジヱクトのハンドル 

與笊終了 NULL 

拡張 エラ ー怙報は GetLastError 関数で取得。 

Local Alloc 関数は移動可能なメモリを; 1 Pj り当てると、メモリのローカルハンドルを返 
す。アプリケーションは、メモリにアクセスするために LocalLockl 対数を使) U してハ 
ンドルをポインタに変換しなければならない。 

LocalAlloc 関数は固定メモリを剖り当てると、メモリを指すポインタを返す。アプリ 
ケーションは戻り M をポインタにキャストするだけでメモリにアクセスできる。 


— Global Alloc ， LocalFree ， LocalLock ， LocalReAlloc，LocalSize 


VirtualAlloc 

kernel 32 .dll 

95 

NT 

仮想メモリを割り当てる 





V C 


V B 


パラメータ 


LPVOID VirtualAlloc ( 

LPVOID IpAddress ， //確保する領域へのポインタ 

DWORD dwSize ， //領域のサイズ 

DWORD JWlocationType , //剖り当ての方法 

DWORD JlProtect //アクセス権 

)； 

Declare Function VirtualAlloc Lib " kernel 32” Alias " VirtualAlloc " (IpAddress As Any , 
ByVal dwSize As Long，ByVal flAllocationType As Long，ByVal flProtect As Long ) 
As Long 


• IpAddress 


• dwSize 

• flA I location Type 


剤り当てのために、费求する領域のアドレスを指定する。ホス 
卜の コンピュータのページ サイズを決定するためには 、 Get 
Systemlnfo 閲数を使う 0 
領域のサイズを指定する。 

領域を割り当てるときの方法を指定する。次の M の t ゝずれか 
を指定する。 
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ifi. 


MEM—COMMIT 

ページの指定された領域ディスクにお^ゝてメモリまたはページ 


ングファイルの物理的な領域を剂り当てる。 

MEM.RESERVE 

プロセスがあらゆる物的な祐域を確保する。確保された範 


は、それが解放されるまで、他の割り当てオペレーション 


(mallocra 数、 LocalAUoc 閲数など)によって利用することは 


できない。 

MEM.TOP.DOWN 

吋能な限り上位のメモリを; 1 W り当てる。 


• JlProtect アクセス保護のタイプを指定する。次のフラグのいずれかを指定す 

る 0 


m 

想味 

PAGE.READONLY 

波み取り 額 

PAGE 一 READWRITE 

麻み窬き 

PAGE 一 EXECUTE 

突行 可能 

PAGE_EXECUTE 一 READ 

突行と説み取り 

PAGE_EXECUTE_READWRITE 

义行と貌み W き 

PAGE_GUARD 

保 

PAGE_NOCACHE 

キャッ シユ 無効 


戻り値 

正常終 r 

剤り当てられたページアドレス 


與你終了 

NULL 


拡张エラー怙報は GetLastError 関数で取得する。 

解説 VirtualAllocI 対数は次の操作を実行できる。 

• 前の呼び出しで VirtualAlloc 閲数に確保されたページ領域を確保する 
• あいているページ領域を確保する 
• 上記の闽方 

参 照 —Global Alloc ， —HeapAlloc ， VirtualFree ， VimialLock ， VirtualProtect，VirtualQuery 


ZeroMemory 


95 

NT 

メモリブロックの内容をすべて〇にする 


v し void ZeroMemory ( 

PVOID Destination. //0 で 初期化す るメモリブロックのアドレス 
DWORD Length //〇 で 初期化する メモリブロックのバイト 数 

)； 

パラメータ • Destination 0で I 刀 期 化するメモリブロックのアドレスを衍定する 0 

• Length 0で 初期化す るメモリブロックのバイト 数を指定す る。 

麥 照 CopyMemory ， FillMemory，MoveMemory 
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ConnectNamedPipe 

kernel 32 .dll 

95 

NT 

名前付きパイプに接続 


V C 


V B 

パラメータ 


戻り値 


解説 


参 照 


BOOL ConnectNamedPipe ( 

HANDLE hNamedPipe ， //名油•付きパイプを識別するハンドル 

LPOVERLAPPED IpOverlapped //OVERLAPPED 構造体へのポインタ 

)； 

Declare Function ConnectNamedPipe Lib M kernel 32" Alias •• ConnectNamedPipe " 
(ByVal hNamedPipe As Long，IpOverlapped As OVERLAPPED ) As Long 

• hNamedPipe 名前付きパイプの終端を識別するハンドルを指定する。この 

ハンドルは CreateNamedPipe 関数により戻される。 

• IpOverlapped OVERLAPPED 構造体へのポインタを指定する。 

正常終 f [ TRUE 
與常終了 FALSE 

拡張エラ ー M •報は GetLastError 関数で取得する 0 

ConnectNamedPipe を使うことで、名前付きパイプのサーバープロセスは、以前の別 
のクライアントプロセスとの接続を利⑴して、新しく作成されたパイプでも利用でき 
る。 


CallNamedPipe ， CreateEvent ， CreateFile ，— CreateNamedPipe ， 

- ♦ DisconnectNamedPipe , GetOverlappedResult , SetNamedPipeHandleState , 
SleepEx ， WaitForMultipleObjects ， WaitForMultipleObjectsEx ， WaitForSingleObject ， 
WaitForSingleObjectEx，—OVERLAPPED 


CreateNamedPipe 

kernel 32 .dll 

■ 

NT 

名前付きパイプを作成 


V C HANDLE CreateNamedPipe ( 


LPCTSTR 

IpName ， 

// 名前付きパイプへのボイ 
ンタ 

DWORD 

dwOpenMode , 

//ノ《イプのオープンモード 

DWORD 

dwPipeMocJe , 

"パイプモード 

DWORD 

nMaxInstances ， 

//インスタンスの敁大値 

DWORD 

nOutBufferSize ， 

//出カバッファサイズ 

DWORD 

nlnBufferSize , 

//入カバッファサイズ 
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V B 


パラメータ 



意味 

PIPE _ ACCESS 一 DUPLEX 

メ乂方向モードで作成する 

PIPE_ACCESSJNBOUND 

クライアントからサーバーにだけ迪 U を行う 

PIPE — ACCESS—OUTBOUND 

サーバーからクライアントにだけを行う 


また、ライト スルー か、オーバーラップかの指定を行う。 



意味 

FlLE _ FLAG _ WRITE_THROUGH 

ライトスルーモードである 

FILE 一 FLAG 一 OVERLAPPED 

オーバーラップモードである 


セーフティアクセスモー ドの設定を次の中から指定する。 



意味 

WRITE 一 DAC 

呼び出し側は任总のアクセスを" I 能にして、アクセス 
コントロールリストを制御する。 

WRITE 一 OWNER 

呼び出し側は名前付きパイブの所有者に対して*き込 
みが許される。 

ACCESS 一 SYSTEM 一 SECURITY 

时•び出し側はシステムアクセスコントロールリストに 
対して;* f き込みが胙される。 


• dwPipeMode 次のタイプモードの t 、ずれかを指定する。 

• 沓き込みモードの埸合は、次の M のいずれかを指定する。 


値 

意味 

PIPE _ TYPE_BYTE 

データはバイトの流れとしてパイプに W か 
れる。 PIPE _ READMODE_MESSAGE と 
同時に指定はできない。 


DWORD nDefaultTimeOut ， 

LPSECURITY.ATTRIBUTES IpSecurityAttributes 


)； 


// タイムアウト間隔 
// SECURITY.ATTRIB UTES 
構造体へのポインタ 


Declare Function CreateNamedPipe Lib M kemel 32" Alias " CreatcNamedPipeA " (ByVal 
lpName As String , ByVal dwOpenMode As Long , ByVal dwPipcMode As Long , ByVal 
nMaxInstances As Long , ByVal nOutBufferSize As Long , ByVal nlnBufferSize As 
Long , ByVal nDefaultTimeOut As Long , IpSecurityAttributes As SECURITY 
_ ATTRIBUTES ) As Long 


lpName 


dwOpenMode 


名前付きパイプの名称を格納した NULL で終わる文字列へのボイ 
ンタを指定する。 

パイプハンドルのパイプアクセスモー ドを指定する。双方向 モー 
ド、ライトスルーモード、 および セーフテイアクセスモード を指定 

する。 

このパラメータは次のパイプアクセスモードフラグのうちの丨つ指 
定する。 
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戻り値 


解脱 

参 照 


PIPE TYPE 一 MESSAGE 


データはメッセージの 流れとしてパイブに 
■■f かれる。 PIPE—TYP 民 _BYTE と M 時に指 
定はできない。 


• 読み込みモードの場合は、次の値のいずれかを指定する。 


Vi . 

意味 

PlPE _ READMODE 一 BYTE 

データはバイトの流れとして说ま 
れる。 

PI PE.TY PE _ MESSAGE , PIPE_TY 
PE 一 BYTE と M 時に指定はできな 
い 

PIPE _ READMODE_MESSAGE 

w 〇 

データはメッセージの流れとして 
M まれる。 

PIPE _ TYPE_MESSAGE が指定さ 
れてぃる坳〇のみ心•効である， 


•ウヱイトモードの坳☆は、次の虓のいずれかを指定する。 


m 

鱗 

PIPE.WAIT 

ブロックモードで勁作する。このモード 
の使 H 1 は、クライアントプロセスが!»力作 
を'•する状況にお t ゝて無糾限に帱つこ 
とを总味している。 

PIPE NOWAIT 

ノンブロックモードで動作する。 


• n^ULxInstances 

• nOutBufferSize 

• nlnBufferSize 

• nDefauItTimeOut 

• IpSecuritxA t tributes 


パイプを利用するアプリケーションインスタンスの W 大を 
拒定する。 

出カバッファのサイズをバイトで指定する。 

入カバッファのサイズをバイトで指定する。 

タイムアウトの発生時問をミリ秒で指定する。 

SECURITY ATTRIBUTES 構造体へのポインタを指定する。 


正常終了 名前 f 、 l •きパイプのサーバー終端を識別するハンドル 

輿 ?IV 終了 INV ALID—H ANDLE—VALUE 

拡张エラ ー M 報は GetLastErrorl 划数で取以する。 


新しい名前付きパイプが作成された坳合、パラメーターからのアクセスコントロール 
リスト （ ACL ) は、名前 f 、 J •きパイプのための任立のアクセスコントロールを定義す 
る。 


— ConnectNamedPipe ， CreateFile ，— ReadFile , ReadFileEx ， 

-^ SECURITY _ ATTRIBUTES , TransactNamedPipe , WaitNamedPipe , WriteFile , 

WriteFileEx 
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CreatePipe 

kernel 32 .dll 


NT 

名前なしパイブを作成 


V C 


V B 


パラメータ 


戻り値 


解説 
参 照 


BOOL CreatePipe( 

PHANDLE hReadPipe ， 
PHANDLE h^/rite Pipe. 

LPSECURITY ATTRIBUTES 


DWORD 

>； 


nSize 


// 人力用パイプを識別するハンドル 
//出力用パイプを識別するハンドル 
IpPipeA ttributes, 

"SECURITY_ATTRIBUTES 梢 [ 造体_/ポインタ 
//パイプに確保されるバッファサイズ 


Declare Function CreatePipc Lib M kemel32 M Alias M CreatePipe M (phReadPipe As Long, 
phWritePipe As Long, IpPipeAttributes As SECURITY_ATTRIBUTES, ByVal nSize 
As Long) As Long 


hReadPipe 

h WritePipe 

IpPipeA ttributes 
nSize 


入力 m パイプを識別するハンドルを格納する変数へのポインタ 
を指定する。 

出力用パイプを識別するハンドルを格納する変数へのポインタ 
を指定する。 

SECURnTY—ATTRlBUTES 構造 f 本へのポインタを指定する。 
パイプのために確保されるバッファサイズを指定する。パラメ 
一夕に 0 が指定された坳合は、デフオルトのバッファサイズが 
利用される。 


正帒終 r 
興常終 r 


TRUE 

FALSE 


拡张エラ ー M 報は GetLastError 閲数で取する 0 

Crea げ ipe 関数は、指定されたパイプサイズを別り当ててパイプを作成する。 
— ReadFile,— SECURITY ATTRIBUTES,WriteFile 
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DisconnectNamedPi 


名前付きパイプの接続を切断 



kernel32.dll 



NT 



V C 


BOOL DisconnectNamedPipe( 
HANDLE hNamedPipe 


// 名前付きパイプを識別するハンドル 


V B Declare Function DisconnectNamedPipe Lib M kernel32 f, Alias M DisconnectNamedPipe M 

(ByVal hNamedPipe As Long) As Long 


パラメータ • hNamedPipe 名前付きパイプを識別するためのハンドルを指定する。パラ 

メータは CreateNamedPipelftl 数によって戻される値を利用する 0 


戻り値 

正 ? ft 終了 

TRUE 


與帘終了 

FALSE 


披張エラー怡報は GetLastErrorIJy 数で取得する。 


解説 サーバープロセスは、ハンドルが ConnectNamedPipeliy 数を使って別のクライアント 

と接続する前に DisconnectNamedPipe _ 数を呼んで、パイプハンドルをその前のクラ 
イアントから切り離さなければならない。 

爹 w ^ CloseHandle ， —ConnectNamedPipe ， —CreateNamedPipe，— FlushFileBufferst 
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CreateProcess 

kernel 32 .dll 


NT 

ブロセスの起動 


V C 


V B 


パラメータ 


BOOL CreateProcess( 

LPCTSTR IpApplicationName, // 突行"丁能モジュール 

へのボインタ 

LPTSTR IpCommandLine. //コマンドライン文字列 

LPSECU R IT Y_ ATTRIBUTES IpProcessA ttributes^ 

//SECURITY ATTRIBUTES 構造体へのポインタ 


LPSECURITY_ATTRIBUTES IpThreadAtthbutes, 

//SECURITY_ATTR1BUTES 構造体へのポインタ 
BOOL blnheritHandles % // ノヽンドルフラグ 


DWORD 

LPVOID 

LPCTSTR 

LPSTARTUPINFO 


tfuc reanonFlags, 

IpEnvironment, 

IpCurrentDirectory, 

IpStartuphifOy 


//作成フラグ 
//® 境変数へのポインタ 
//カレントデイレクト 
リ名へのポインタ 
//STARTUPINFO 構造 
体へのポインタ 


LPPROCESS 一 INFORMATION IpProcessInformation 

//PROCESS INFORMATION 構造体へのポインタ 


)； 


Declare Function CreateProcess Lib "kemel32" Alias "CreateProcessA" (ByVal 
IpApplicationName As String, ByVal lpCommandLine As String, IpProcessAttributes 
As SECURITY 一 ATTRIBUTES, 

• IpApplicationName 実能モジュールを識別する NULL で終わる义字列へのポ 

インタを指定する。 

• lpCommandLine コマンドラィンを格納する NULL で終わる文字列へのポィン 

夕を指定する。ファイル名にフルパス名が指定されなかった 
場合、次の )! 肪 y; でファイルを探す。 

1. アプリケーションのロードディレクトリ 

2. カレントディレクトリ 

3. Windows 95 の場 A は、 GetSystemDirectory 閲数で取得 
できるシステムディレクトリ。 WindowsNT の坳合は、 
GetSystemDirectory I 対数で取 ft# できる 32 ビット用システ 
厶ディレクトリ。 
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4. WindowsNT のみ、 16 ビツト用のシステムデイレクトリ。 

5. GetWindowsDirectoryl 対数で取得できる Windows デイレ 
クトリ。 

6. パス環境変数に記述されたディレクトリ。 

• IpProcessAttributes 作成されるプロセスの怙報を格納した SECURITY^ATTRI 

BUTES 構造体へのポインタ。 

• IpThreadAttributes 作成されるスレツドの悄報を格納した SECURITY_ATTR1 

BUTES 構造体へのポインタ。 

• blnherit Handles 次の値のいずれかを指定する。 



意味 

TRUE 

呼び出し元のハンドルを引き継ぐ 

FALSE 

新しいハンドルが割り当てられる 


• dwCreationFlags プロセスのプライオリティクラスと作成を制御する付加的な 

フラグを指定する。次のフラグのいずれかを指定する。 


m 

意味 

CREATE _ DEFAULT _ ERROR_MODE 

新しいブロセスは呼び出しプロセスのエラーモード 
を引き継がない。代わりに Create Process 数は、 
新しいプロセスに祝/£のデフオルトエラーモードを 
与える。 

CREATE _ NEW_CONSOLE 

新しいプロセスは、親のコンソールをづ|き継ぐ代 
わりに新しいコンソールを持つ。 
DETACHED _ PROCESS と M 時に扔定できない。 

CREATE 一 NEWJ > ROCESS 一 GROUP 

新しいプロセスは新しいプロセスグループのベース 
プロセスである。ブロセスグループは、 CTRL-fC 
または CTRL + BREAK シグナルを1グループのコン 
ソールブロセスに送ることを可能にするために、 
GenerateConsoleCtrlEvent 閲 数で 利用 される。 

CREATE 一 SEPARATE _ WOW_VDM 

新しいブロセスは 私 実上 DOS マシン （ VDM ) とし 
て 勁 作する。 

CR E ATE 一 S H A RED _ WOW_VDM 

Windows NT : WIN .1 NI の [ WINDOWS ] セクシ 3 ン 
の DefaultSeparateVDM スイツチが TRUE の从)介、 
このフラグは CreateProcess 開数のスイッチを無効 
にして、プロセスが分別された如実上の新しい 
DOS マシンを起動する。 

CREATE.SUSPENDED 

新しいプロセスのスレッドは、保留状態で作成さ 
れて、 ResimieThreadliy 数が呼ばれるまで動かな 

ぃ。 
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CREATE 一 UNICODE 一 ENVIRONMENT 
DEBUG.PROCESS 


DEBUG 一 ONLY 一 THIS_PROCESS 


DETACHED 一 PROCESS 


IpEnvironment により衍し小された頌境変数ブロッ 
クが Unicode 文字を使う。 

呼び出しプロセスはデバッガとみなされて、新しい 
プロセスは、バグを取り除いているプロセスであ 
る 0 呼び出しスレッド （ CreateProcess を呼んだス 
レッド）が、 WaitForDebugEvent 開数を呼ぶこと 
ができない限り、システムはプロセスに存在するす 
ベてのデバッグ唞象をデバッガに通知する。 

このフラグが丨设定されず、呼び出しプロセスをデ 
バッグしている拗合、新しいプロセスは、呼び出 
しプロセスによって別のデハ # ッガプロセスになる。 

コンソール プロセスのため、新しいプロセスは親プ 
ロセスの コンソールに 入出力できない。 CREATE . 
NEW CONSOLE と Iii 辦には指定できない。 


dwCreationFlags パラ メータ は新しいブロセス を 制御する〇つぎのプライ 
オリティクラスフラグの蛸をどれも指定しな t 叫合、作成プロセスのブラ 
イオリティクラスが IDLE_PRIORITY_CLASS でな t 、限り、プライオリテ 
ィクラスは NORMAL_PRIORITY_CLASS となる。この坳作、子プロセス 
のデフオルトプライオリティクラスは IDLE PRIORITY CLASS である。 



患味 

HIGHJ > R 10 RITY—CLASS 

このプライオリテイクラスブロセスのスレッ 
ドは、迪帘のブライオリティまたはアイドル 
プライオリテイクラスプロセスのスレッドに 
俺先して実行される。 

IDLE _ PRIOR ! TY_CLASS 

スレッドはシステムがアイドルで、より“い 
ブライオリティクラスで勁作するプロセスの 
スレッドに灾行_位を先取りされる。 

NORMAL _ PRIORITY_CLASS 

特にスケジューリングする必®のない、通 
のプロセスを示す。 

REALTIME _ PRIORITY_CLASS 

W も、ブライオリティを持って1、るプロセ 
スを示す。リアルタイムプライオリティクラ 
スプロセスのスレッドは他のあらゆるプロセ 
スのスレッドに设先する。 


• ip environment 

• IpC urrentDirectory 

• IpStartupInfo 

• IpProcessInformation 


パラメータが NULL の坳合、新しいプロセスは呼び出しプ 
ロセスの環境変数を使う。 

カレントディレクトリを識別するフルパス名が格納された 
NULL で終わる文字列へのポインタを指定する。 

新規プロセスのメインウィンドウの情報を格納した START 
UP1NF0 構造 ( 本へのポインタを指定する。 

新規プロセスの紱性を格納する PROCESS. 
INFORMATION 構造体へのポインタを指定する。 
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戻り値 

拡張エラー怡報は GetLastError 関数で取得する 0 

解説 CreateProcess|5y 数は、新しいプログラムを実行するために用いられる。 WinExec と 

Load Module 閲数も利用可能だが、これらの呼び出しは CreateProcess によ つて 実行さ 
れる。プロセスを発生させるだけでなく、 CreateProcess 関数は スレッド オブジェクト 
も作成する。 スレッドは、 サイズが指定されるプログラムの実行可能なファイルのイ 
メージへッダーにおいて 記述され ている 初期の スタックで 作成される。 

参 照 AllocConsole,CloseHandle,CreateRemoteThread,-^CreateThread,ExitFrocess, 

ExitThread,GenerateConsole^trltvent,GetCommandLine,GetEnvironmentStrmgs, 
GetExitCodeProcess，— Get Full PathName，GetS tartu pin fo，— GetSystem Directory, 
—GetWindowsDirectory ， —LoadModule ， OpcnProcess ， —PROCESS 」 NFORMATION ， 
ResumeThread,-^SECURITY_ATTRIBUTES,SetConsoleCtrlHandler, 

- ♦SetErrorMode,STARTUPINFO,TerminatePrc>cess,WaitForInputIdle, 
WaitForDebugEvent，— WinExect 



CreateThread 



ッドオブジ 


クトの作成 



95 NT 


V C HANDLE CreateThread( 

LPSECURITY.ATTRIBUTES IpThreadAttributes, 

//SECURITY_ATTRmUTES 構造体へのポインタ 
DWORD dwStackSize ， //初期スタックサイズ 

LPTHREAD—START_ROUTINE lpStartAddress y // スレッド IW 数へのポインタ 

LPVOID IpParameter, //パラメータ 

DWORD dwCreationFlags ， //作成フラグ 

LPDWORD IpThreadld //スレッド識別子を格納す 

る変数へのポインタ 

)； 

パラメータ • IpThreadAttributes 作成するスレッド价報を格納した SECURITY_ATTRIBUTES 

構造体へのポインタ。 

• dwStackSize 初期のスタックサイズをバイトで指定する。 

• IpStciriAddress スレッドにより実行される I 対数を識別するアドレスへのボイ 

ンタを指定する。 

• IpParameter スレッドに引き渡されるパラメータの ■ を指定する。 

• dwCreationFlags 新しいスレッドの作成時に適用されるスレッドの W 性を指定する。 
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意味 

CREATE _ DEFAULT_ERROR 一 MODE 

新しぃプロセスは呼び出しプロセスのエラーモード 
を引き継がなぃ。代わりに CreateProcess 関数は、 
新しぃプロセスに現在のデフォルトエラーモードを 
与える。 

CREATE _ NEW 一 CONSOLE 

新しぃプロセスは、親のコンソールを引き継ぐ代わ 
りに新しぃコンソールを持つ。 
DETACHED _ PROCESS と同時に指定できなぃ。 

CREATE _ NEW _ PROCESS_GROUP 

新しぃプロセスは新しぃプロセスグループのベース 
プロセスである。プロセスグループは、 CTRL + C ま 
たは CTRL + BREAK シグナルを1グループのコンソ 
ールブロセスに送ることを可能にするために、 
GenerateConsoleCtrlEvem 開数で利 Jfl される。 

CREATE _ SEPARATE _ WOW_VDM 

新しぃプロセスは啪突上 DOS マシン （ VDM ) とし 
て®;作する。 

CREATE 一 SHARED _ WOW_VDM 

Windows NT : WIN . IN 1 の [ WINDOWS ] セクション 
の DefaultSeparateVDM スイッチが TRUE の場合、 
このフラグは CreateProcess 181数のスイッチを無効 
にして、プロセスの分削された如実上の新しぃ 
DOS マシンを 起動す る。 

CREATE_SUSPENDED 

新しぃプロセスのスレッドは、保留状態で作成さ 
れて、 ResumeThread 開数が呼ばれるまで®;かな 

い d 

CREATE_UNICODE 一 ENVIRONMENT 

IpEnvironment により指し示された頌境変数ブロッ 
クが Unicode 文字を使う。 


• IpThreadld 作成されたスレッドの識別子を格納する変数へのポインタを指定する。 


戻り值 

正常終了 

スレッドオブジヱクトの ハン ドル 


異常終了 

NULL 


拡張エラー怡報は GetLastError 関数で取得する。 

—CloseHandle ， —CreateProcess ， CreateRemoteThread ， ExitProcess ， ExitThread ， 
GetExitCodeThread,GetThreadPriority,ResumeThread,SetThreadPriority, 

— SECURITY ATTRIBUTES 
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GetCurrentProcess 

kernel32.dll 

95 

NT 

現在のブロセスを取得 


V C HANDLE GetCurrentProcess() 

V B Declare Function GetCurrentProcess Lib ”kernel32” Alias "GetCurrentProcess" () As 

Long 

戻り値 現在のプロセスを識別する pseudohandle 。 

pseudohandle は、現在のプロセスハンドルと解釈される特別な定数である。プロセス 
ハンドルが必埂な場合、呼び出しプロセスはいつでも A 分白分のプロセスを指定す 
るために、このハンドルを … いることができる。 pseudohandle は子プロセスにリ I き継 
がれない。 

参 照 —CloseHandle,DuplicateHandle,GetCurremProcessId ， —GetCurrentThread，OpenProcess 


GetCu rrentTh read 

kernel32.dll 

95 

NT 

現在のスレッドオブジェクトを取得 





V C HANDLE GetCurrentThread() 

V B Declare Function GetCurrentThread Lib M kemel32 M Alias "GetCurrentThread" () As 

Long 


戻り値 Si 在のスレッドを識別する pseudohandle 。 

pseudohandle は、現在のスレッドハンドルと解釈される特別な定数である。スレッド 
ハンドルが必要な場合、呼び出しプロセスはいつでもそれ自分のスレッドを指定する 
ために、このハンドルを用いることができる。 pseudohandle は子プロセスに引き継が 
れない。 

爹照 CloseHandle,DuplicateHandle,GetCurrentProcess,GetCurrentThreadId 
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WinExec 

kernel32.dll 

95 

NT 

ほかのアプリケーションを実行 





V C UINT WinExec ( 

LPCSTR IpCmdLine ， // コマンドライン文字列へのポインタ 

UINT uCmdShow //アプリケーション起勒時のスタイル 

)； 

V B Declare Function WinExec Lib "kemeI32" Alias "WinExec" (ByVal IpCmdLine As 

String，ByVal nCmdShow As Long) As Long 

パラメータ • IpCnuiLine アプリケーションを龙行するためのコマンドライン（フアイル名と 

オプションのパラメータ）を格納した NULL で終わる文字列へのポ 
インタ。ファィル名、パラメータともに全角文字を衍定することが 
可能。ファィル名にパス名が含まれない場合、閲数は次の順け;でデ 
ィレクトリを検索する。 

1. 呼び出し元アプリケーションがロー ドされたディレクトリ 

2. カレントディレクトリ 

3. Windows システムディレクトリ 0 GetSystemDirectory 閲数で取 fU できるデ 
ィレクトリ 

4. Windows デイレクトリ〇 GetWindowsDirectory 閲数で取 W できるディレ 
クトリ 


5. PATH 環境変数内にリストされているディレクトリ 
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• uCmdShow アプリケーション起動時のスタイルを指定する。非 Windows アプリ 

ケーションの埸合は、アプリケーション用のプログラム愔報フアイ 
ル （ PIF ) によりウィンドウの状態が決定される 0 uCmdShow パラメ 
一夕には次の値の I ゝずれかを指定する。 


m 


总味 


SW HIDE 


ウィンドウを#表示にし、ほかのウ 
する 


ドウをアクティブ化 


SW.MAXIMIZE 

SW.MINIMIZE 

SW RESTORE 


指定されたウィンドウを W 大化 

指定されたウィンドウを lii 小化し、タスクリストのトップに 
位趵させる 

ウィンドウをアクティブ化し表示。ウィンドウが W 小化また 
は W 人化されている場合には元のサイズと位趵に復元 
(SW SHOWNORMAL と等価） 


SW SHOW 


ウィンドウをアクティブ化し現在のサイズと位! i v f で表示 


SW SHOWDEFAULT STARTUP 1 NFO 構造体の怙報を利 Hi する 


SW.SHOWMAXIMIZED 
SW.SHOWMINIMIZED 
SW 一 SHOWMINNOACTIVE 

SW SHOWNA 


ウィンドウをアクティブ化し Jii 大化及示する 

ウィンドウをアクティブ化し W 小化表示する 

ウィンドウを W 小化。现 ft アクティブなウィンドウはアクテ 
ィブな状態を維持する 

ウィンドウを祝/!■:の状態で表示。现 / E アクティブなウィンド 
ウはアクティブな状態を維持する 


SW . SHOWNOACT 1 VATE 以前に衣示されたサイズと位!«でウィンドウを衣示。現在ア 

クティブなウィンドウはアクティブな状態を維持する 

SW_SHOWNORMAL ウィンドウをアクティブ化し表示。ウィンドウが W 小化また 

は敁大化されて I ゝる場合には元のサイズと位趵に復元 


戻り値 

正常終了 

31 以上 


異常終了 

次の flft の 1 ゝずれかを返す 


飢 

总味 

0 

メモリもしくはリソースが不足している 

ERROR _ BAD_FORMAT 

指定されたファイルが実行可能形式のファイルではない 

ERROR 一 FILE 一 NOT 一 FOUND 

指定されたファイルが兌つからない 

ERROR _ PATH _ NOT_FOUND 

指定されたパス名が正しくない 


參 照 CreateProcess,GetMessage,GetSystemDirectory^GetWindowsDirectory,LoadModule, 

ShowWindow 
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Registory 



RegCreateKey 

advapi32.dll 

95 

NT 

キーを作成またはオーブン 


V C 


V B 

パラメータ 


戻り値 


解脱 


参 照 


LONG RegCreateKey( 

HKEY hKey\ // オープンするキーを識別するハンドル 

LPCTSTR IpSubKey, // オープンもしくは作成するサブキーを指定する NULL 

で終わる文字列へのポインタ 

PHKEY phkResult //オープンもしくは作成されたキーのハンドル 
)； 


Declare Function RegCreateKey Lib ,f advapi32.dil M Alias M RegCreatcKeyA M (ByVal 
hKey As Long, ByVal IpSubKey As String，phkResult As Long) As Long 


• hKey 

オープンするキーを識別するハンドルを指定する。パラメータに指 
定できる値は次の通り予約されている。 


HKEY 一 CLASSES 一 ROOT 

HKEY_CURRENT_USER 

HKEY_LOCAL_MACHINE 

HKEY_USERS 

• IpSubKey 

オープンもしくは作成するサブキーを指定する NULL で終わる文字 
列へのボインタ。 

• phkResult 

オープンもしくは作成されたキーのハンドル。 

正常終了 

ERROR_SUCCESS 

異常終了 

エラー値 


アプリ ケー シヨン はんパラメータに HKEY_CLASSES_ROOT を指定することで、 
ト ップレベルの データベースに従诚するキーを作成することができる。また、 
RegCreateKey 関数を使用して、一度に构数のキーを作成することもできる。 
IpSubKey ， 《ラメータに次の形式の文字列を指定すると レベルの 深さが 4 で、 先行する 
3 つの サブキーを持つサブキーを作成することができる。 


subkey 1 \subkey2\subkey3\subkey4 


RegCloseKey ， —RegCreateKeyEx ， —RegDeleteKey ， RegOpenKey ， RegOpenKeyEx ， 
—RegSetValue 
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RegDeleteKey 

advapi 32 .dll 

95 

NT 

キーを削除 


V C 


V B 

パラメータ 


戻り値 


解脱 
参 照 


LONG RegDeleteKey( 

HKEY hKey, // オープンするキーを識別するハンドル 

LPCTSTR IpSubKey // 削除するサブキーを指定する NULL で終わる文字列へ 

のポインタ 


)； 


Declare Function RegDeleteKey Lib M advapi32.dll M Alias ” RegDeleteKeyA” (ByVal 
hKey As Long, ByVal IpSubKey As String) As Long 

• hKey オープンするキーを識別するハンドルを指定する 0 パラメータに指定でき 

る値は次の通り予約されている。 



HKEY 一 CLASSES 一 ROOT 


HKEY_CURRENT_USER 


HKEY_LOCAL_MACHINE 


HKEY_USERS 

• IpSubKey 

削除するサブキーを指定する NULL で終わる文字列へのポインタを指 
定する。 

正常終了 

ERROR.SUCCESS 

異常終了 

エラー 値 


WindowsNT では RegDeleteKey I 知数を利用して、サブキーを持つサブキーを削除する 
ことはできない。 

RegCloseKey,-^RegCreateKeyEx,RegOpenKevEx 
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V C LONG RegSetValue( 

HKEY hKey ， // 値を設定するキーを識別する ハンドル 

LPCTSTR IpSubKey ， // 値を設定するサブキーを識別する NULL で終わる文字 

列へのボインタ 

DWORD dwType ， //設定する 値の タイプ 

LPCTSTR IpData ， // 設定する f め:を格納した NULL で終わる文字列へのボイ 

ンタ 

DWORD chData // 設定する蛸のサイズ 
)； 

V B Declare Function RegSetValue Lib ”advapi32.dir’ Alias ’•RegSetValueA • (ByVal hKey 

As Long，ByVal IpSubKey As String, ByVal dwType As Long, ByVal IpData As 
String, ByVal cbData As Long) As Long 

パラメータ .hKey オープン する キーを 識別する ハンドルを 指定する。 パラメータに 指定で 

きる诚は次の通り予約されている。 

HKEY_CL ASSES 一 ROOT 
HKEY_CURRENT_USER 
HKEY_LOCAL_MACHINE 
HKEY_USERS 

• IpSubKey f め:を設定するサブキーを識別する NULL で終わる文字列へのポインタ。 

- dwType 設定する値のタイプ。 REG_SZ タイプを指定しなければならない。他の 

タイプのキーを設定する場合には、 RegSetValueExI 划数を利用する。 

• IpData 設定する値を格納した NULL で終わる文字列へのボインタを指定する。 

• cbData I 没定する侦のサイズを指定するが、これに終端の NULL 文字は含まれ 

ない 0 

戻り値 

解説 IpSubKey パラメ ータで指定されたキーが存在しな t 、ときは、 RegSetValue 関数がキー 

を作成する。 RegOpenKey 関数を使ってオープンされてかつ RegCloseKey 関数の呼び 
出しで クローズ される キーに 対して RegSetValue 関数の呼び出しを実行すると システ 
ムの見げ！速度が向上する。 

梦 照 RegCreateKeyEx,RegFlushKey,RegOpenKeyEx,RegQueryValue,RegQueryValueEx, 

RegSetValueEx 



指定されたキーにテキスト文字列を関連付ける 


ReaSetValue 


advaDi 32 .dll 


NT 


95 


5 / VI HI 卜411 f >4 
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wmmmmmmmmm 




Resource 






Loadlmage user32 . di1 95 nt 

リソースからビットマップイメージをロード 


v c HANDLE LoadImage( 


HINSTANCE 

hinst. 

LPCTSTR 

IpszName, 

UINT 

"Type ， 

int 

cxDesired, 

int 

cy Desired, 

UINT 

fuLoad 


)； 


//イメー ジが格納されているアプリケーシヨンの 
インスタンスを識別するハンドル。 

//ビットマップイ メー ジのリソース識別子 
//ビットマップイ メー ジタイプ 
//イ メー ジの幅 
//イ メー ジの高さ 
//ロードフラグ 


V B Declare Function Loadlmage Lib "user32" Alias "LoadlmageA" (ByVal hlnst As Long, 

ByVal lpsz As String, ByVal uni As Long, ByVal nl As Long，ByVal n2 As Long ， 
ByVal un2 As Long) As Long 

パラメータ • hinst ロー ドするイメージを含むモジュールのインスタンスを識別するハン 

ドルを指定する。 OEM イメージをロードするには、このパラメータを 
を 0 に設定する。 

• IpszName ロー ドするイメー ジを識別する文 '/ 列へのポインタを指定する。 hinst 

パラメータが NULL 以外で、 fuLoad パラメ - 夕が LR_LOADFROM 
FILE を含まな t 、埸合、 IpszName は / 2 /> 1 灯モジュールのイメージリソー 
スの名前を含む NULL で終わる文字列へのボインタである。 hinst が 
NULL で、 LR_LOADFROMFILE が指定されていない坳合、このパラ 
メータの下位ヮードは、ロー ドする OEM イメー ジの識別子である。 
OEM イメージ識別子は WINUSER.H で定義され、次の接頭辞を持つ。 


接頭辞 

意味 

OBM _ 

OEM ビットマップ 

OIC _ 

OEM アイコン 

OCR 一 

OEM カーソル 


Windows 95 では、 fuLoad , 气ラ メータが LR—LOADFROMFlLEfift を含 
んで t ゝる埸合、 IpszName はイメー ジを含んで t 、るファイル名である。 
Windows NT では、 LRJLOADFROMFILE は無視される。 

• uType ロー ドするイメージのタイプを指定する。次の値のいずれかを指定する。 
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戻り 値 


参 照 



意味 

IMAGE 一 BITMAP 

ビッ トマ ップ 

IMAGE 一 CURSOR 

カーソル 

IMAGE JCON 

アイコン 


• cxDesired ロードされるィメー ジの幅を指定する。 

• cy Desired ロードされるィメー ジの高さを指定する 0 

• fuLoad 次の値の組み合わせを指定する。 


flft 


立味 


LR DEFAULTCOLOR デフォルト。なにも処理はしない。 


し R CREATEDIBSECT 10 N 


Windows 95 。 uType バ ラ メータが IMAGE—BIT 
MAP を指定している坳合、 DIB セクションビット 
マップを戾す。衣示装趵の色にあわせたカラーマ 
ップを作らずにビットマップをロードする場合に 
有効。 


LR DEFAULTSIZE 


Windows 95。 cxDesired 、 c ) のゴの 4 ft が0に ! S 
定されている坳合、カーソルとアイコンのための 
システムメトリクス綃に坫づいた幅、“さを設定 
する。 


LR.LOADFROMFILE Windows 95 。 IpszName バラ メータで指定される 


フアイルからイ メー ジを ロー ドす る。 


LR LOADMAP 3 DCOLORS 


LR LOADTRANSFARENT 


LR MONOCHROME 


Windows 95。 イメージのためのカラーテーブルお 
よび グレース ケールのシヱー ドを 3 D カラーと交換 
する。対応は「•シヱ ード 対 3D カラー」 を参照。 
Windows 95。 イメージの Jii 初のピクセルのカラー 
侦を取り出し、 カラーテーブルのデフォルトウィ 
ンドウ 色と交換する ( COLOR _ WINDOW ) 0 

Windows 95。白说イメージでロードする。 


LR SHARED 


Windows 95。イメー ジを共有口 J 能な状態でロード 
する。 


參シ I ー ド対 3 D カラー 


色 

交換色 

Dk Gray ， RGB ( 128,128，128> 

COLOR _3 DSHADOW 

Gray , RGB (192 J 92,19 2) 

COLOR -3 DFACE 

Lt Gray ， RGB (223, 223,22 3) 

COLOR _3 DUGHT 


正常終了 ロー ドされたイメージのハンドル 

異常終了 NULL 


Copy Image，— GetSystemMetrics，-^ LoadBitmao^ LoadCursor，— Loadlcont 
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LoadResource 

kernel 32 .dll 

95 

NT 

リソースを□一 k 


V C 

V B 

パラメータ 


戻り値 


解説 


参 照 


HGLOBAL LoadResource( 

HMODULE hModule, //ロー ドするリソースを持つ実行可能モジュールのハ 

ンドル 

HRSRC hResInfo //ロードするリソースのハンドル 

)； 

Declare Function LoadResource Lib M kemel32" Alias "LoadResource" (ByVal hlnstance 
As Long, ByVal hResInfo As Long) As Long 

• hMoclule ロー ドするリソースを持つ実行 nj 能モジュールのハンドルを指定す 

る。 NULL を指定した場合は、现 /K のプロセスのモジュールが参照 
の対象となる。 

• hResInfo ロードするリソースのハンドルを指定する。このハンドルは 

FindResource もしくは FindResourceExI 划数により取得する。 


正常終了 ロードされたリソースが；切り当てられたグローバルメモリブロック 

の ハン ドル 

興你終 r NULL 

拡張エラー怙報は GetLastError^l 数で取得。 

アプリケーションはリソースの 使⑴を終えたら、 I 划迚する グローバル メモリを 
FreeRescmrce 閲数を使用して解放しなければならない 0 指定されたリ ソースが すでに 
ロー ドされている場合には、関数は リソースの 参照 カウン トを增加させるだけであ 
る。 


FindResource,FmdResourcetx,FreeResource,LoadLibrarvXoadModuleXockResource 


String Manipulation 


画 





CharNext 

user 32 .dll 

95 

NT 

文字列内の次の文字に移動 


V C LPCSTR CharNext( 

LPCTSTR Ipsz // 現在のキャラクタを格納する NULL で終わる文字列へのポインタ 
)； 

V B Declare Function CharNext Lib "user32" Alias "CharNextA" (ByVal lpsz As String) As 

String 
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パラメータ • Ipsz 現在のキヤレット位置にある文字を示す NULL で終わる文字列へのボイ 

ンタを指定する。 

戻り値 正常終了 f 次の文字へのボインタもしくは NULL 文字 

窄 照 Char Next ExA，Char Prev 


CharUpper 

user 32 .dll 

95 

NT 

文字を大文字に変換 

V C LPTSTR CharUpper( 




LPTSTR Ipsz // 文字もし 

くは文字列へのポインタ 




V B Declare Function CharUpper Lib M user32 M Alias ,f CharUpperA M (ByVal Ipsz As String) 

As String 

パラメータ .Ipsz NULL で終わる文字列へのポインタもしくは 1 文字を指定する。上位ワー 

ドが〇の埸合、下位ワードには単一の 1 文字が指定される。 

戻り値 変換後の文字列へのボインタ。 

誓 照 - ♦CharLower,CharLowerBuff,CharUpperBuff 


CompareString 

kernel 32 .dll 

95 

NT 

2 つの文字列を比較 


V C 


V B 


int CompareStnng( 

LCID Locale, 
DWORD dwCnipFlugs, 
LPCTSTR IpStringl. 
int cchCount 1 ， 

LPCTSTR lpString2, 
int cchCount2 


//® 境識別子 
// 比較スタイル 
// 第 1 文字列へのポインタ 
// 第 1 文字列のサイズ 
// 第 2 文字列へのポインタ 
// 第 2 文字列のサイズ 


Declare Function CompareString Lib "kemel32" Alias "CompareStringA" (ByVal 
Locale As Long, ByVal dwCmpFlags As Long, ByVal IpStringl As String, ByVal 
cchCountl As Long, ByVal lpString2 As String, ByVal cchCount2 As Long) As Long 
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パラメータ 


戻り値 


参 照 


• U>cale 次の識別子のいずれかを指定する。 


flfl : 

总味 

し OCALE 一 SYSTEM_DEFAUUT 

システムデフオルト 

LOCALE 一 USER 一 DEFAULT 

ユーザーデフオルト 


• dwCmpFlags 比較の方法を指定するフラグを設定する。デフォルトではフラグ 

は設定されていない。 



总味 

NORMJGNORECASE 

大文字と小义字の比較はしない 

NORMJGNOREKANATYPE 

ひらがなとカタカナを区別しない 

NORMJGNORENONSPACE 

スペースを無祝 

NORMJGNORESYMBOLS 

紀号を無祝 

NORMJGNOREWIDTH 

1バイト文字と2バイト文字を区別しない 

SORT STRINGSORT 

句説点を! k ! 号として扱う 


• IpStringl 第1文卞列へのポインタを衍定する。 

• cchCountl 第1文字列のサイズを指定する。 

• lpString2 第2文字列へのポインタを指定する。 

• cchCount2 第2文字列のサイズを指定する。 

次の I ゝずれかの戻り値を返す。 


1 IpStringl パラ メータは、 lpString2 パラ メータより語数が少ない。 

2 IpStringl パラメータは、 lpSthng2 パラメータと同じ語数である。 

3 IpStringl パラ メータは、 lpString2 パラ メータより語数が多い。 


0 異常終了 


拡張 エラ ー怙報は GetLastError_ 数で取得する 0 


FoldString ， GetSystemDefaultLCID ， GetUserDefaultLCID ， LCMapString ， lstrcmp ， lstrcmpi ， 
—MAKELCIDt 
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FormatMessage 

kernel 32 .dll 

95 

NT 

メッセージ形式を設定 


V C DWORD FormatMessage( 


DWORD 

dwFlags ， 

// 処理进択フラグ 

LPCVOID 

IpSource, 

// メッセージ文字列へのポインタ 

DWORD 

dwMessageld ， 

//メッセージ ID を識別 

DWORD 

dwLanguageld, 

//メッセージ言語を識別 

LPTSTR 

IpBuffer ， 

//メッセージの格納されるバッファへのボインタ 

DWORD 

nSize ， 

// メッセージノ《ッファのサイズ 

va 一 list 

^Arguments 

// メッセージ rtil 列のアドレス 


)； 

V B Declare Function FormatMessage Lib "kemel32" Alias ff FormatMessageA f, (ByVal 

dwFlags As Long，IpSource As Any，ByVal dwMessageld As Long，ByVal 
dwLanguageld As Long，ByVal IpBuffer As String, ByVal nSize As Long, Arguments 
As Long) As Long 

パラメータ • dwFlags 幣形の方法を指定する//パラメー タをどのように編集するかの 1 

セットのビットフラグを含む。 dwFlags の！ : 位バイ トは、機能ハンドル 
ラインの出カバッファを指定する。下位バイトは、フォーマットされ 
たアウトプットラインの W 大幅を指定している。次の値のいずれかを 
指定する。 



意味 

FORMAT _ MESSAGE _ ALLOCATE_BUFFER 

フォーマットされたメッセージを保 
存するのに十分なバッファを剤り 
当て、 IpBuffer で衍定されたアドレ 
スへのポインタを保持する。メッ 
セージが不 ® になった坳合は、バ 
ッファを解放するために、 
Local Free 閲数を用いる。 

FORMAT _ MESSAGEJGNORE_INSERTS 

不変の出乃バッファであることを 
指定する。 

FORMAT _ MESSAGE _ FROM_STRING 

IpSource が NULL で終わる文字列 
へのポインタであることを示す。 

FORMAT 一 MESSAGE 一 FROM_HMODULE 

IpSource がメッセージテーブルリソ 
ースを含むモジュールハンドルであ 
ることを示す。 

FORMAT 一 MESSAGE _ ARGUMENT_ARRAY 

32 ビット W の ft ] 列へのポインタで 
あることを示す。 
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戻り値 

解説 

参 照 


Avf/a 私の下位バイトは、幣形されたアウトプツトラインの Jli 大幅を指定 
する。次の値のいずれかを指定する。 



意味 

0 

アウトプット彳 j •幅に制限がない。 

〇以外 

アウトプットラインの文字の W 大 


数を指定している。 

FORMAT 一 MESSAGE_MAX_WIDTH_MASK 

メッセージ定義テキストでのライ 


ン破衆を無祝する。 


• IpSource 


• dwMessa^ehl 


• dwLan^ua^eld 


• IpBuffer 


• nSize 


• Arguments 


メッセージ 定在の位 & v (を指定する。 このパラメータのタイ プは 
dwFlags パラ メータでのセッティン グに 依々 : する。 ふ，ぬ职の , 设定 
が、 FORMAT _ MESSAGE _ FROM _ HMODULE ， FORMAT _ 
MESSAGE _ FROM _ STRING 以外の坳作、 l /? So"rce は無税 される。 
•松求され たメッセージのメッセージ 識別/を指定する。 dwFla^s 
が FORMAT _ MESSAGE _ FROM _ STRING をきむ坳合、このパ 
ラメータは無 祝される。 

戏求されたメッセージの言語識別子を指定する。 dwFI 叫 s が 
FORMAT - MESSAGEJROM 一 STRING をさむ場合、このパラメ 
ータは無祝される。 

メッセージのための NULL で終わる文字列バッファへのポイン 
夕。 (IwFlags が FORMAT _ MESSAGE 一 ALLOCATE_BUFFER を 
含む場合、関数は、 LocalAlloc 関数を使ってバッファを别り当 
て、指定されたアドレスバッファを//， 价ガび に設定する。 
FORMAT _ MESSAGE _ ALLOCATE_BUFFER が設定されていた 
場合、このパラメータは出カバッファに保存されるバイト 
( ANSI バージョン）または文字 （ Unicode バージョン）の lii 
大数を指定する。 

メ ッ セージに 渡される パラメータの 値を指定す る。％ 1は第丨パ 
ラメータを％ 2は第2 パラメータを 指定す る。 


正常終了 出カバッファに返されるバイト数 (ASCII) もしくは文字 (Unicode) 

興常終了 0 

拡張エラー怡報は GetLastError 関数で取 W する 0 


メッセージテキスト内には、メッセージを ! 6/J 的に整形するため、いくつかのエスケー 
プシーケンスが利用される。 


— LoadStnngXocalrree 
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GetTimeFormat 

kernel 32 .dll 

95 

NT 

時間文字列形式を取得 


VC int GetTimeFormat( 


LCID 

Locale ， 

// 幣形される環境 

DWORD 

dwFlags ， 

//整形の方法 

CONST SYSTEMTIME 

*lpTime, 

//SYSTEMTIME 構造体へのボインタ 

し PCTSTR 

IpFormat ， 

//時間形式文字列へのポインタ 

し PTSTR 

lpTimeStr, 

//憋形された文字列を格納するバッファへ 
のポインタ 

int 

cchTime 

//幣形された文字列を格納するバッファサ 


V B Declare Function GetTimeFormat Lib "kemel32 M Alias ’’GetTimeFormatA 11 (ByVal 

Locale As Long，ByVal dwFlags As Long，lpTime As SYSTEMTIME, ByVal IpFormat 
As String，ByVal lpTimeStr As String，ByVal cchTime As Long) As Long 

パラメータ • Locale 文字列を幣形する環境を次から } S 択して衍定する。 


m 

意味 

LOCALE_SYSTEM_DEFAULT 

システムデフオルト 

LOCALE_USER_DEFAULT 

ユーザーデフオルト 

dwFlags W 式化の方法を指定するフラグを次の t ゝずれかから設定する。 

• m 

总味 

し OCALE_NOUSEROVERRIDE 

関数は、指定され たシステムデフオル ト時冏形 
式を使って文字列を整形する。 

TIME 一 NOMINUTESORSECONDS 

分 または秒を利川しない。 

TIME_NOSECONDS 

秒を利用しない。 

TIME.NOTIMEMARKER 

タイ厶 マーカー を利用しない。 

TIME_FORCE24HOURFORMAT 

24 時間形式。 


• lpTime 幣形される時問怡報を含む SYSTEMTIME 構造 { 本へのポインタ。 

NULL の 場合は、現在の ローカルシステム 時間を利用する。 


,V >JHI A 41 If VJ 
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• IpFormat が NULL の場合、閲数は指定された環垃の時問形式を使 

う。代替文字はそれぞれ次の通りの怠味を持つ。 


文字 

怠味 

h 

12 時問形式、 0 詰めされない「時」 

hh 

12 時間形式、 0 詰めされた「時」 

H 

24 時間形式、 0 詰めされない「時」 

HH 

24 時間形式、 0 詰めされた 「 B $」 

m 

0 詰めされない「分」 

mm 

0 詰めされた「分」 

s 

0 詰めされない「秒」 

ss 

0 詰めされた「秒」 

t 

A もしくは P で 表される、 タイムマーカー 

tt 

AM もしくは PM で 衣される、 タイムマーカー 



• IpTimeStr 

整形された時間を受け取るための文字列へのポインタを指定する。 
NULL の場合は、現在の ローカルシステム 時問を利用する。 


• cchTime 

IpTimeStr のバッ ファのサイズをバイト (ANSI) もしくは文字 (Unicode) 
で指定する ' cchTime が 0 の坳合 、整形された時問を受け取るために 
必费なバイト数もしくは文字数を戻し、 /p77m^S ぴにより指し示され 
たバッファは使われない。 

戻り値 

ii : 常終广 

整形された時間文字列のバイト数 


興常終了 

0 


拡張エラー愔報は GetLastError 関数で取得する 
参 目 GetDateFormat，— SYSTEMTIME 
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V C mt LoadStnng( 

HINSTANCE Mnstance ， //文字列リソースを格納しているモジュールイン 

スタンスのハンドル 

UINT m/D, //ロー ドする文字列を指定する幣数識別子 

LPTSTR IpBuffer ， //文字列を受け取るバッファへのポインタ 

int nBuJferMax //バッファのサイズを指定 

)； 

V B Declare Function LoadString Lib M user32" Alias "LoadStringA” (ByVal hlnstance As 

Long，ByVal wID As Long，ByVal IpBuffer As String, ByVal nBufferMax As Long) As 
Long 

パラメータ • hlnstance 文字列リソースを格納しているモジュールインスタンスを識別する 

ためのハンドル。 

- u/D ロー ドする文字列を識別する整数識別子を指定する。 

• IpBuffer 文字列を受け取る NULL で終わる文字列へのボインタ。 

• nBufferMax 文字列とで終わるの NULL を格納するのに十分なバッファサイズを 

指定する。バッファサイズに入りきらない文字列が返された坳合に 
は、文字列は切りつめられる。 

戻り值 正常終了 文字列のサイズがバイトで返される 

異常終了 0 

拡張エラ — 怙報は GetLastError 関数で取得。 

参 ^ FormatMessage,LoadAccelerators ， —LoadBitmap ， LoadCursor ， LoacHcon ， LoadMemj ， 

LoadMenuIndircct 


文字列リソースをロード 


user32.dll 


LoadStrin 


NT 


95 


•>>4HIJ>4ln:>4 
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MultiByteToWideChar kemei 32 .di 1 95 nt 

マルチバイト文字をワイド文字へマップ 


V C 


V B 


パラメータ 


int MultiByteToWideChar( 
UINT CodePage ， 
DWORD dwFlags, 
LPCSTR IpMultiByteStr, 
int cchMultiByte, 

LPWSTR IpWideCharStr, 
int cchWideChar 

)； 


II コー ドページ 

// キャラクタタイプ 

//マツプする文字列へのポインタ 

//マツプする文字列のサイズ 

//ワイド文字を格納する文字列へのポインタ 

//ワイド文字を格納する文字列のバッファサイズ 


Declare Function MultiByteToWideChar Lib M kemel32 M Alias "MultiByteToWideChar" 
(ByVal CodePage As Long, ByVal dwFlags As Long，ByVal lpMultiByteStr As String, 
ByVal cchMultiByte As Long, ByVal IpWideCharStr As String, ByVal cchWideChar 
As Long) As Long 

•CodePage 変換するために用いられるコードページを指定する。次の値は、シス 

テムデフォルトコードページのうちの丨つを指定するために設定する。 



dwFhgs マツ ビングの方法を次の t ゝずれかの値で指定する。 


MB PRECOMPOSED 


MB COMPOSITE 


MB_ERR INVALID CHARS 


MB USEGLYPHCHARS 


总味 _ 

デフオルト。すべての文字とスペース文字はシン 
グル文字としてマップされる。 MB_COMPOSITE 
と Inj 時には指定できない。 

常にコンポジットキャラクタを利用する 。 MB 
PRECOMPOSED と MBj には指定できない。 

間数が無効な入力文つけた場合、火敗する。 
GetLastError 開数を利用することで、 ERROR _ 
NO _ UNICODE_TRANSLATION が返される。 

コントロールキャラクタの 代 わりに glyph 义ネを使 


• lpMultiByteStr 


変換される文字列へのボインタを指定する 
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• cchMultiByte IpMultiByteStr パラメ ータで示された文字列のサイズを指定す 

る。この値が -1 の埸合、文字列は無効である。 NULL で終わ 
る文字の長さは自動的に計算される。 

• IpWideCharStr 変換後の文字が格納される文字列へのポインタを指定する。 

• cchWideChar IpWideCharStr ， 《ラメータで示された文字列のサイズを指定す 

る。この値が〇の埸合、閲数は//バッファを利用 
しない。 

戻り値 正常終 r (cchWideChar = 0 以外） IpWideCharStr^ 《ラメータに返された文字列の 

サイズ 

I 卜:常終 f (cchWideChar = 〇 ) 変換後の文字列を受け取るのに必要な バッフ 

ァサイズ 

異常終了 0 

エラー怡報は GetLastError 関数で取得する。 

解説 め你 S/;* と//^/み CtorS ぴ 文字列へのポインタは同じであってはならない。これら 

が冏じ埸合、関数は失敗し GetLastError は ERR0R_INVAL1D_PARAMETER を返す。 
MB_ERRJNVAL1D_CHARS が設定されて、マップする文字に無効な文字が見つか 
った埸合も閲数は失敗する。 

参 照 WideCharToMultiByte 


ぐ >4HIA4ln:>4 
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Structured Exception Handing 


AbnormalTermination 


卜 finally の状態を返す 




NT 


戻り値 


解説 


BOOL AbnormalTermination(); 


try-finally ステートメントが輿沿終广した埸合 
それ以外の場合 


TRUE 

FALSE 


try ブロック内のすべてのステートメントが順次実行され、敁後のステートメントま 
で到述した埸 A のみが try ブロックの正常終 f である。例外や return 、 goto 、 continue 、 
break などのステートメントが実行された坳合などは try ブロックの與帒終了と利断す 
る。 

MapWindowPoints ， P01NT，ScreenToClient 



GetExceptionCode 


例外の種類を返す 



NT 


DWORD GetExceptionCodeO; 


例外のタイプを識別する。 ’ 次の例外コードのいずれかが返される。 


EXCEPTION_ACCESS_VIOLATION 


EXCEPTION.BREAKPOINT 
EXCEPTION DATATYPE MISALIGNMENT 


EXCEPTION ARRAY BOUNDS EXCEEDED 


EXCEPTION.FLT DENORMAL OPERAND 


EXCEPTION_FLT 一 DIVIDE 一 BY_ZERO 
EXCEPTION_FLT_INEXACT_RESULT 
EXCEPTION FLT INVALID OPERATION 


EXCEPTION FLT OVERFLOW 


总味 

スレッドは、不当な仮想アドレスを说み 
込むもしくは,* J き込もうとした。 

ブレーク ポイントに} fl 遇した。 

スレッドは、不迚絞なアドレス空間への 
アクセスを試みた。 

スレッドが、アクセスを禁止されている 
W 列®索にアクセスすることを試みた。 

浮泐小数点演 P : のオペランドの丨つが不 
正。 

0 の汀®小数点除 M で除？)[を,试みた。 

泞勋小数点演党の結果が不正。 

このリストに含められないあらゆる浮勅 
小数点演の例外を表す 3 

浮！助小数点演兑の結米がオー ノ く ー フロー 
した。 
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EXCEPTION _ FLT _ STACK_CHECK 

EXCEPTION_F じ T 一 UNDERFLOW 

EXCEPTION 一 INT 一 DIVIDE 一 BY_ZERO 

EXCEPTION _ INT_OVERFLOW 

EXCEPTION.PRIVJNSTRUCTION 

EXCEPTION NONCONTINUABLE E ； 


スタックのオーバーフロー もしくは浮 
勅小数点演兑の結采がア ン ダー フロー 
する。 

汶勁小数点演兑の結果が許される侦よ 
りも少ない。 

スレッドは整数の 0 除兑を試みた。 

整数演兑の結果が不正。 

スレッドが、 ％/ E のマシンモードでは 
許されない操作を火行しようと試み 
た。 

スレッドは琳紱不能な例外を起こした 
後なお、処理を継統しようとした。 


解脱 


参 照 


GetExceptionCode 閲数は 、 try except ステートメントのフイルタ表现または例外取り 
扱いブロック内で0乎ばれる。以下に try except ステートメントの構造を示す。 

try{ 

/* try block */ 

} 

except (filter-expression) { 

/* exception handler block */ 

} 

— GetExceptionlnformation，— RaiseException 
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GetExcepiionlnTormation 


95 

NT 

例外の詳細情報を返す 


V C LPEXCEPTION_POINTERS GetExceptionlnformationO; 

戻り値 例外エラーに問する詳細怙報が含まれる EXCEFHON_RECORD 構造体と、ハードウ 

エア状態の trt 報が含まれる CONTEXT 構造 f 本へのポインタを格納した EXCEPTION_ 
POINTERS 祸造体へのポインタが返される。 

参照 — CONTEXT，— EXCEPTION_POINTERS,— EXCEPTION.RECORD, 

GctExceptionCode 


RaiseException 

kernel 32 .dll 

95 

NT 

例外を発生させる 


V C 


V B 


パラメータ 


解説 
参照 


VOID RaiseException( 

DWORD dwExceptionCode, 


DWORD d wException Flags ， 

DWORD nNumberOfA rguments, 

CONST DWORD *lpArguments 


// 例外コード 

// 私!行吋能例外フラグ 

//况列の费尜数 

//文卞列配列へのポインタ 



Declare Sub RaiseException Lib "kernd32" Alias M RaiseException f, (ByVal 
dwExccptionCcxle As Long, ByVal dwExceptionFIags As Long, ByVal 
nNumberOfArguments As Long, IpArguments As Long) 


• dwExceptionCode アプリケーション定義された例外コードを指定する。 

- dwExceptionFIags 例外フラグを指定する。次の f め : のいずれかを指定する。 


Vi 

总味 

紱行" I 能な例外 

0 

統行不能な例外 

EXCEPTION 一 NONCONTINUABLE 

nNumberOfA rguments 

/ 尸パ/贈心 fid 列にお t ゝて驳索の数を指定する0 
EXCEPTION.MAXIMUM.PARAMETERS を越え 
てはならない。 IpArguments が NULL の埸合ノ《ラメ 
一夕は無祝される 


• IpArguments 32 ビット値を持つ配列へのポインタ。 

RaiseException I 対数は、プロセスが独自に定義したアプリケーション定義の例外を、 
構造化例外として扱うことを可能にする。 


ExitProcess.-^GetExcemionCode,—^GetExceptionlnformation^Wait^orDebugEvent 
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SetUnhandledExceptionFilter 

kernel 32 .dll 

95 

NT 

例外フィルタ関数を設定 


V C 


V B 

パラメータ 


戻り値 


解脱 

參 照 


LPTOP 一 LEVEL 一 EXCEPTIONLFILTER SetUnhandledExceptionFilter( 

LPTOP—LEVEL 一 EXCEPTI0N_F1LTER IpTopUvelExceptionFilter 

//例外フイルタ閲数へのポインタ 


)； 


Declare Function SetUnhandledExceptionFilter Lib "kemel32" Alias "SetUnhandled 
ExceptionFilter" (ByVal IpTopLevelExceptionFilter As Long) As Long 


• Ip TopLe vel Exception Filter UnhanciledExcepiionFiherlJy 数へ制御が移るときに 

呼ばれるトップレベルの例外フィルタ関数へのボイ 
ンタ。 この パラメータが NULL の坳合は、 Un 
handledExceptionFilter 内で扱っているデフオルトを 
总味する。フィルタ機能は以下の侦のうちの1つを 
戻す。 


总味 


EXCEPTION EXECUTE HANDLER 


EXCEPTION CONTINUE EXECUTION 


EXCEPTION CONTINUE SEARCH 


UnhandledExceptionFilter から/ズり、1埘連した例外 
を'龙行する0これは通你プロセスの終广を总 I 味する。 

UnhandledExceptionFilter から1人彳り、例外のポイン 
卜から実行を続ける。 

UnhandledExceptionFilter の ll •:你な龙行を統行す 
る。 


SetUnhandledExceptionFilterliy 数は、設定された以前の例外フイルタのアドレスを 1 大 ; 
す。戾り侦が NULL の埸合は、現在のトップレベルの例外がまったくないことを立味 
している。 


SetUnhandledExceptionFilter は、呼び出しプロセスでのすベてのスレッドのトップレ 
ベル 例外 フィルタを 設定する0 

— UnhandledExceptionFilter 
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UnhandledExceptionFilter 

kernel32.dll 

95 

NT 

アプリケーションの例外をフぅ 

「ルタする 


V C LONG UnhandledExceptionFilter( 

STRUCT EXCEPTION.FOINTERS *ExceptionInfo 

//EXCEPTION POINTERS 構造体へのボインタ 


V B Declare Function UnhandledExceptionFilter Lib M kernel32_. Alias "UnhandledException 

Filter" ( Exceptionlnfo As EXCEPTION-POINTERS ) As Long 

パラメータ • Exceptionlnfo 例外時の例外記述と プロセッサ ステートメントを含む 

EXCEPTI0N_P01NTERS 構造体へのポインタを指定する。 
このポインタは GelExceptionInformation 閲数の尿り f め : である。 


戻り値 次の値の t ゝずれかを返す。 



立味 


EXCEPTION _ CONTINUE_SEARCH プロセスからバグを取り除き、例外はアプリケー 

ションのデバッガに渡される。 

EXCEPTION 一 EXECUTE 一 HANDLER 以前の呼び出しで SEM_NOGPFAU じ TERROR 

BOX フラグが SetErrorMode に指定されていた坳 
合、アプリケーションはエラーメッセージボック 
スを在示しない。 


解説 プロセスからバグを取り除けない坳合、 I 划数はアプリケーションのエラーメッセージ 

ボックスを表示する。デフォルトではダイアログボックスを表示する必要があるが、 
呼び出し時に SetErrorMode 関数で SEM_NOGPFAULTERRORBOX を指定すること 
で無効にできる。システムは、内部でのプロセスとスレッドの作成時に起こるハンド 
ル例外に UnhandledExceptionFilter を使う 0 

参照 — EXCEPTION_POINTERS，— GetExceptionInformation,SetErrorMode, 

— SetUnhandledExceptionFilter 
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GetComputerName 

kernel32.dll 

95 

NT 

現在のコンピュータ名を取得 


V C 


V B 

パラメータ 


戻り値 


参 照 


BOOL GetComputerName( 

LPTSTR IpBujfer ， // コンピュータ名を格納する文字列へのポインタ 
LPDWORD nSize //コンピュータ名を格納するバッファサイズ 

)； 

Declare Function GetComputerName Lib M kcmcl32 M Alias M GetComputerNamcA M 
(ByVal lpBuffer As String，nSize As Long) As Long 

• lpBuffer コンピュータ名を受け取る NULL で終わる文字列を格納するバッフ 

ァへのボインタを指定する。 

•nSize lpBuffer パラメータのサイズをバイ ト数で衍定する。ここで指定す 

るバイト数はコンピュータ名と終端の NULL 文字の合針俯である。 
ili 人 fl 貞は MAX 一 COMPUTERNAME_LENGTH+ 1 バイトで I •分で 
ある0 


正常終了 TRUE 。 nSize パラ メータに NULL 文字をのぞ t ゝた実サイズが返される 

異常終了 FALSE 

拡張 エラ ー 怙報は GetL ⑽ Erro. 数で取得0 


SetComputerName 


GetSystemlnfo 

kernel32.dll 

95 

NT 

現在のシステム情報を返す 


V C void GetSystemInfo( 

LPSYSTEM—INFO IpSystemlnfo //SYSTEM JNFO 構造体へのポインタ 

)； 

V B Declare Sub GetSystemlnfo Lib ”kernel32" Alias "GetSystemlnfo" (IpSystemlnfo As 

SYSTEM JNFO) 

パラメータ • IpSystemlnfo SYSTEM-INFO 構造体へのポインタを指定する。 

^ 照 —SYSTEM INFO 
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GetUserName 

advapi32.dll 

95 

NT 

ユーザー 名を返す 


V C BOOL GetUserName( 

LPTSTR IpBuffer ， // ユーザー名を受け取る NULL で終わる文字列へのポイ 

ンタ 

LPDWORD nSize II 受 け取った文字列を格納するバッファサイズ 

)； 


V 0 Declare Function GetUserName Lib M advapi32.dll M Alias •GetUserNameA” (ByVal 

lpBuffer As String，nMze As Long) As Long 


パラメータ 

• lpBuffer 

• nSize 

ユーザー名を受け取り格納するための NULL で終わる文字列へのポ 
インタを指定する。パラメータで指定されるバッファが1•分なサイ 
ズを有していな t ゝ坳合に Iftl 数は輿常終 / する。 

ユーザー名を格納するためのバッファサイズをバイト数で指定する。 

戻り値 

正常終了 

TRUE 


異常終了 

FALSE 


拡張エラ - 

• 怙報は GetLastError 1 对数で取以。 


解説 閲数が正你に終了した場合には、，ぶびパラメータに取得したユーザー名のサイズが 

設定される。股定されるサイズは lpBuffer パラメータの 内容と輿なり NULL で終わる 
文字列は含まれない。純粋なユーザー名部分のサイズである。 

參 照 LookupAccountName 
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GetVersion 

kernel32.dll 

95 

NT 

Windows のバージョン情報を取得 


V c DWORD GetVersion (); 

V 3 Declare Function GetVersion Lib M kemel 32 M Alias " GetVersion •• () As Long 


戻り値 関数が止:? r ? に終了した場合は、プラットフオーム os のメジャーバージョン番号とマ 

イナーバージョン番弓•を返す。 


プラツトフオーム 

上位ワード 

下位ワード（メジャーバージョン） 

WindowsNT 

0 

3もしくは4 

Windows 95 

1 

4 


解説 I 划数が正帘に終了した坳合は、戻り W のド位ワードに Windows のバージョンが格納 

される。上位ワードにはマイナーバージョン（リビジョン）番号が 2 桁の 10 進数とし 
て格納される。 

参照 GetVersionEx 
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G etW indowsDi rectory 

Windows デイレクトリのバスを取得 


kernel32.dll 


95 


NT 


V C 

V B 

パラメータ 

戻り値 

解脱 

参 照 


UINT GetWindowsDirectory ( 

LPTSTR IpBuffer , // Windows ディレクトリ名を格納する NULL で終わる文字 

列へのポインタ 

UINT uSize //ディレクトリ名を受け取るバッファサイズ 
)； 

Declare Function GetWindowsDirectory Lib " kernel 32" Alias ' GetWindowsDirectoryA '' 
(ByVal IpBuffer As String , ByVal nSize As Long ) As Long 

• IpBuffer Windows ディレクトリ名を格納する NULL で終わる文字列へのポイン 

夕を指定する。 

• “Size Windows ディレクトリ名を受け取るバッファのサイズをバイト数で衍 

定する。 

茲:7ネ終了 Windows ディレクトリのパス名のバイト数 

異常終了 0 

拡张エラー怡報は GetLastError |5 y 数で取以。 

取得する Windows ディレクトリのパス名には、末ぼに\記号は付かない。ただし、 
Windows ディレクトリがルートディレクトリの坳合に限り\記号が付加される。たと 
えば、 C ドライブの Windows というディレクトリに Windows がインストールされてい 
る坳合に閲数が返す值は C :\ Windows 。 C ドライブのルートにインストールされてい 
た場合には CA と返される。 

GetCurrentDirectory.GetSystemDirectory 
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I Time 



F1 


CompareFileTime 

kernel32.dll 

95 

NT 

2 つの 64 ビットのファイル時間を比較 


V C 


V B 

パラメータ 


戻り値 


参 照 


LONG CompareFileTime( 

CONST FILETIME *//W レ 77/7;W，//H f 、 l * の比較を行う対象となる第 1 IIM * 
CONST FILETIME *lpFileTime2 // ti 忖の比較を fJ 1 う対象となる第 2 日 
)； 

Declare Function CompareFileTime Lib M kernel32" Alias .CompareFileTime" 
(IpFileTimel As FILETIME, lpFileTime2 As FILETIME) As Long 

• IpFileTimel の比較を行う第 1 の 64 ビット旧十を格納する NULL で終わる文 

字列へのポインタを指定する。 

• lpFileTime2 日付の比較を行う第 2 の 64 ビット [If 、 } • を格納する NULL で終わる文 

字列へのポインタを指定する。 

I 知数が1卜 : 常に終 r した坳合には次の値のいずれかが返される。 

~\ 1 第1パラメータの日付が小さい 

0 ふたつの日付は等しい 

+1 第丨パラメータの Hf 、 l •が大きい 

拡张エラー怙報は GetLastError 閲数で取价〇 


GetFileTime,—FILETIME 
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FileTi meToSy stemTi me kemei32 . di1 95 nt 

64 ビット形式の時間をシステム時間に変換 


V C 

V B 

パラメータ 

戻り値 

解脱 

参 照 


BOOL FileTimeToSystemTime( 
CONST FILETIME *lpFileTime, 
LPSYSTEMTIME IpSystemTime 

)； 


// 変換する 64 ビット日付へのポインタ 
//変換後のシステ厶日付を格納する 
SYSTEMT1ME 構造体へのポインタ 


Declare Function FileTimeToSystemTime Lib M kemel32 M Alias "FileTime 
ToSystemTime" (IpFileTime As FILETIME, IpSystemTime As SYSTEMTIME) As 
Long 

• IpFileTime 日 N* 形式の変換を行う 64 ビット日 f 十へのポインタを衔定する。 

• IpSystemTime. 変換された日付を格納するための SYSTEMTIME 構造体へのポイン 

夕を指定する。 

正常終了 TRUE 

興常終了 FALSE 

拡張エラー怙報は GetLastErrorl 対数で取得。 

[I N • の変換に失敗した坳合に間数は FILETIME 構造体に 0x8000000000000000 以上の 
値を返す。 


DosDateTimeToFileTime ， —FILETIME ， FileTimeToDosDateTime ， —SYSTEMT1ME ， 
SystemTimeToFileTime 


GetSy stemTi me kemei32 . di1 95 nt 

システムの時刻と日付を返す_ 

V C void GetSvstemTime( 

LPSYSTEMTIME IpSystemTime //SYSTEMTIME 構造体へのポインタ 

)； 

V B Declare Sub GetSystemTime Lib ”kemel32" Alias "GetSystemTime" (IpSystemTime As 

SYSTEMTIME) 

パラメータ • IpSystemTime SYSTEMTIME 構造体へのポインタを指定する。 

参 照 GetLocaITime,GetSystemTimeAdjustment,—► SetSystemTime，— SYSTEMTIME 
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CreateDesktop 

user 32 .dll 

95 

NT 

デスクトップを作成 


V C 


V B 


パラメータ 


HDESK CreateDesktop( 


LPCTSTR 

IpszDesktop ， 

し PCTSTR 

IpszDevice, 

LPDEVMODE 

4 

pDevMode, 

DWORD 

dwFlags ， 

DWORD 

dwDesiredAccess, 

し PSECURITY 

ATTRIBUTES 


)； 


ガデスクトップ名を格納する文字列への 
ポインタ 

"デスクトップを表示する表示装矜デバ 
イス への ポインタ 

// 予約済み 。 NULL 

//アプリケーションの関係を示すフラグ 
//戻されるデスクトツプハンドルへのア 
クセス 

Ipsa "SECURITY 一 ATTRIBUTES 構 

造体へのポインタ 


Declare Function CreateDesktop Lib •user32" Alias "CreateDesktopA” (ByVal 
IpszDesktop As String，ByVal IpszDevice As String，pDevmode As DEVMODE, ByVal 
dwFlags As Long, ByVal dwDesiredAccess As Long, Ipsa As 
SECURITY_ATTRIBUTES) As Long 


• IpszDesktop 

• IpszDevice 

• pDevMode 

• dwFlags 


作成されるデスクトップを衍定する NULL で終わる文字列へのポ 
インタ。デスクトップ名に大文字小文字の区別はない。 

デスクトップに刻り当てるための表示装趵デバイスを識別する 
NULL で 終わる文字列へのポインタ。 扣出⑼心 が NULL の坳合、 
ブート時にロー ドされたデフ オル トのディスプレイドライバが使 
われる。 

予約された値。 NULL を指定する。 

呼び出し元アプリケーションがデスクトップ上の他のアプリケー 
ションとどのように関係するかを示すフラグ。0または以下の値 
を指定する。 


値 

意味 

DF_ALLOWOTHERACCOUNTHOOK 

他のアカウントからの使用も認める 


• dwDesiredAccess デスクトップへのアクセスタイプを次の I ゝずれかで指定する。 


値 

意味 

DESKTOP 一 CREATEMENU 

メニューを作成する 
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戻り値 


解説 
参 照 


DESKTOP 一 CREATEWINDOW 

DESKTOP.ENUMERATE 

DESKTOP 一 HOOKCONTROL 

DESKTOP JOURNALPLAYBACK 

DESKTOPJOURNALRECORD 

DESKTOP.READOBJECTS 

DESKTOF_SWITCHDESKTOP 

DESKTOP—WRITEOBJECTS 
• Ipsa 


ウィンドウを作成する 
幣列させる 

ウィンドウフック制御を行う 
ジャーナル鉍冉生を実行する 
紀鉍中のジャーナルを実行する 
オブジェクトを取得する 
SwitchDesktop 閲数を使ってデスクトップ 
を実行する 

デスクトップにオブジェクトを作成する 


デスクトップのセキュリティ怡報を格納した SECURITY_ATTR1BUTES 
構造体へのポインタを指定する。 


正帘終了 デスクトップのハンドル 

異常終 r NULL 

拡張エラー怙報は GetLastErroi • 関数で取得する。 

Create Desktop 間数はデスクトップにアクセスするために利用するハンドルを返す 0 


- ♦SECURITY_ATTRIBUTES,SetProcessWindowStation,-*SwitchDcsktop 


Create WindowStation 


■ 

NT 

ウインドウステーシヨンの作成 


V C 


パラメータ 


HWINSTA CreateWindowStation( 
LPTSTR 

DWORD 

DWORD 


Ipwinsta. //ウィンドウステーションを 

示すポインタ 

dwReserved ， // f’ 約済み 。 NULL 

dvvDesiredAccess ， II 決 される ハンドルへのアク 

セス 


LPSECURITY.ATTRIBUTES Ipsa 、 //SECURITY-ATTRIBUTES 構 

造体へのポインタ 


• Ipwinsta 作成されるウィンドウステーションの名前を指定する NULL で 

終わる文字列へのポインタ。ウィンドウステーション名では大 
文字と小文字は区別されない。竹理者グループのメンバーだ 
けに、名前を指定することが許される。 //nv/ 似 m が NULL の坳 
合、システムはウィンドウステーション名を成形し、呼び出し 
プロセスのログオンセッション識別子を使う。この名前を得る 
ためには、 GetUserObjectlnformation 閲数を利用する。 

• dwReserved 予約された flft 。 NULL を指定する。 
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• dwDesi red A ccess ウィンドウステーションへのアクセスのタイプを指足する。パ 

ラメータは次の値から複数を指定することができる。 


m 

意味 

WINSTA_ACCESSCLIPBOARD 

クリップボードを使⑴する 

WINSTA_ACCESSGLOBALATOMS 

グローバルアトムを操作する 

WINSTA 一 CREATEDESKTOP 

新規のデスクトップオブジヱクトを作成する 

W INSTA_EN UMDES KTOPS 

デスクトップオブジェクトを列节する 

WINSTA.ENUMERATE 

ウィンドウステーションを列爷する 

WINSTA.EXITWINDOWS 

Exi(Windows または ExitWindowsExlW 数の呼び 


出しを行う 

WINSTA 一 READATTRIBUTES 

ウィンドウステーションオブジェクトの W 性を 


取得する 

WINSTA_READSCREEN 

p 场而コントロールを找作する 

WIN STA_W RITEATTRIB UTES 

ウィンドウステーションの W 性を変 1 "する 


• Ipsa ウィンドウステーションのセキュリティ M •報を格納した SECURITY— 

ATTRIBUTES 構造体へのポインタを指定する。 


戻り値 

正常終了 

作成されたウイ 

ンドウステーションのハンドル 


與帒終了 

NULL 



拡张エラー怡報は GetLastErrorl 対数で取得する 
参照 GetUserObjectInformation,OpenWindowStation 


ぐ >4HI J> 4le* y4 
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Get Process WindowStation 


ンハンドルの取得 


V C 

V B 

戻り値 

解説 

参 照 


HWINSTA GetProcessWindowStation(); 

Declare Function GetProcessWindowStation Lib "user32" Alias "GetProcessWindow 
Station" () As Long 

正常終了 f 呼び出し元プロセスが所诚するウィンドウステーションハンドル 
異常終了 NULL 

拡張エラー怙報は GetLastErrorliy 数で取得する 

プロセスが発生する坳合、システムはウィンドウステーションをプロセスと姑び付け 
る 0 そのウィンドウステーションを変史するために、プロセスが SetProcess 
WindowStation 関数を利用できる 0 呼び出しプロセスは、呼び出しにおいて、 
GetUserObjectlnformation 、 GetUserObjectSecurity 、 SetUserObjectlnformation 、およ 
び SetUserObjectSecurityl 対数から得たハンドルが利 ) II できる 0 

GetThreadDesktop.GetUserObjectlnformation.GetUserObjectSecurity, 

SetProcessWindowStation,SetUserObiectInformation,SetUserObjectSecurity 


Switch Deskto 


デスクトップを変更する 



user32.dll 



NT 


V C 


BOOL SwitchDesktop( 

HDESK hDesktop // デスクトップを識別するハンドル 


V B 


パラメータ 


戻り値 


Declare Function SwitchDesktop Lib M user32" Alias "SwitchDesktop" (ByVal hDesktop 
As Long) As Boolean 


• hDesktop ァクティブなデスクトツプを識別するハンドルを指定する。ハンド 

ルは Create Desktop と OpenDesktop _ 数の戻り 値で ある。デスクトツ 
プが見えないウィンドウステーションに诚している場合 、 Switch 
Desktop 関数は失敗する。 

正常終了 TRUE 

異常終了 FALSE 

拡張エラー怡報は GetLastError_ 数で取得する 0 


CreateDesktop^OpenDesktop 
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付 録 


付録 A 機能別 API —覧 


本香の「第2章 Win 32 API リファレンス」で説明している API 関数を機能別に分類し、 API 関数 
名、機能、掲載ページをまとめた一 K 表を以下に掲戧する。 

アルファべッ ト順の一覧は、「付録 B アルファべッ ト順 API — KJ を参照しても らいたい。 


• Window : フレーム ウィンドウオブジェクトの作成から破棄にいたるまでの操作を管理する 


AdjustWindowRect 

指定されたクライアント M 域に合うように、ウィンドウのサイズを針兑する 

28 

CreateWindow 

オーバラップウィンドウ、ポップアップウィンドウ、子ウィンドウを作成する 

29 

DestroyWindow 

ウィンドウを破棄する 

32 

GetWindow 

ウィンドウハンドルを取得する 

33 

GetWindowRect 

ウィンドウ全体の寸法を取得する 

34 

GetWindowText 

ウィンドウタイトルをバッファにコビーする 

34 

MoveWindow 

ウィンドウのサイズと位趵を変更する 

35 

SetWindowText 

ウィンドウのタイトルやテキストを設定する 

36 


• Caret :キヤレツトオブジェクトの作成から破棄にいたるまでの操作を管理する 


CreateCaret 

キヤレットを作成する 

36 

GetCaretPos 

现在のキヤレットの位矜を返す 

37 

HideCaret 

指定されたウィンドウからキヤレットを削除する 

38 


• Clipboard :クリップボード操作の制御と管理を目的にした関数 


CloseClipboard 

クリップポードをクローズする 

38 

EmptyClipboard 

クリップボードを空にし、クリップボードの所有権を再度 ; 1 W り当てる 

39 

GetClipboardData 

クリッブボードからデータを取得する 

39 

OpenClipboard 

クリップポードをオーブンする 

40 


• Common Dialog Box : Windows が提供するコモンダイアログボックスオブジェクトの作成とデー 

夕通信を中心とした関数 


ChooseColor 

色を逍択するためのダイアログボックスを作成する 

40 

ChooseFont 

フォントを) g 択するためのダイアログボックスを作成する 

41 

FindText 

テキストを検索するためのダイアログボックスを作成する 

42 

GetFileTitle 

ファイル名を取得する 

43 

GetOpenFileName 

フアイルをオープンするためのダイアログボックスを作成する 

43 

GetSaveFileName 

ファイルを保存するためのダイアログボックスを作成する 

44 

PageSetupDlg 

印刷べージ設定のダイアログボックスを作成する 

45 

PrintDlg 

テキストを印刷するためのダイアログボックスを作成する 

46 

ReplaceText 

テキストを趵換するためのダイアログボックスを作成する 

47 
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付録 A 機能別 API —覧 


• Cursor :マウスのカーソル形状を管理する関数 


CreateCursor 

2 つのビットマスクからマウスカーソルを作成する 

48 

GetCursorPos 

マウスカーソルの位!«を（スクリーン座標で)取得する 

49 

LoadCursor 

マウスカーソルリソースを ロー ドする 

49 

Ix>adCursorr romFile 

ファイルからマウスカーソルリソースをロードする 

51 

ShowCursor 

マウスカーソル表示カウントを 1 つ彻加または 1 つ減少させる 

52 


• Icon :アイコン操作に関する関数 


ArrangelconicW mdows 

アイコン化されたウィンドウを整列する 

52 

CreatelconF romKesource 

アイコンリソースからアイコンを作成する 

53 


# Message and Message Queue : メツセージ処理を行う関数 


DispatchMessage 

スクリーンセーバーの パ スワードを変 1 Ji •する 

54 

GetMessage 

アプリケー シヨ ンのメッセージキューからメッセージを取 fif する 

55 

Send Message 

1 つ以 h のウインドウにメッセージを送る 

56 


• Mouse Input :マウス入力時の動作と管理を行う関数 


Releaseiapture 

マウスキャプチャーを終 r する 

57 

Set し apture 

マウスキャプチャーを開始する 

57 

SetDoubleClickTime 

マウスのダブルクリック時問を設定する 

58 


• Painting and Drawing :フレームウインドウに対する描画処理を中心とした関数 


Begin Paint 

描 _ 処理のためにウィンドウを準備する 

58 

D raw An i mated Rects 

アニメーション描 w 如域を作成する 

59 

RedrawWindow 

ウィンドウを洱描_する 

60 

UpdateWindow 

ウィンドウを史新する 

62 


• Rectangle :指定長方形領域の操作に関する関数 


IntersectRect 

W 描両のための方形をマークする 

62 

OffsetRect 

指定された畏方形を 移勋 する 

63 

SetRect 

J4 方形の座を設定する 

63 

_ Timers : 

タイマーオブジェクトの作成と管理に関する関数 


Kiimmer 

指定されたタイマーイベントを削除する 

64 

SetTimer 

システムタイマーを生成する 

65 
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付 録 


•Window Class :ウィンドウクラスの管理と操作に関する関数 


GetClassInfo 

ウイ 

ンドウクラス怙報を取得する 

66 

RegisterClass 

ウイ 

ンドウクラスを登録する 

66 

UnregisterClass 

ウイ 

ンドウクラスをウインドウクラステーブルから削除する 

67 


# Window Property :ウィンドウの属性に関する関数 


GetProp 

プロパテイリストを取得する 

68 

SetProp 

プロパテイリストを•没定する 

68 


• Common Controls : Windows が提供するコモンコントロール操作に関する関数 


GetEffectiveClientRect 

クライアン ト領域妬形範 M 計？?： 

70 

InitCommonControIs 

コモンコントロール DLL 確立 

71 

ShowHideMenuCtl 

メニュー チ i ック W 性と表示非衣示 115 定 

71 


♦ Drag List Box :ドラッグリストボックスの操作に関する関数 


Drawlnsert 

アイコン描幽 

72 

LBItemFromPt 

リスト泊 H インデックス 検出 

72 

MakeDragUst 

ドラッグリストボックス作成 

73 

# Property Sheet :ブロパテイシートとそのページ操作に関する関数 

Add PropSheetPageProc 

プロパティシー ト ページ 迫 加 

73 

CreatePropertySheetPage 

新規プロパティシートページ作成 

74 

DestroyPropertySheetPage 

プロパティシートページ 破棄 

74 

ExtensionPropSheetPageProc 

プロパティシートページ拡張 

75 

Property^heet 

プロパティシート表示 

75 

PropSheetPageProc 

プロパティシートページ 初期化 

76 

PropSheetProc 

プロパティシー ト初期化 

77 

• Status Window : ステ - 

•タスバーウィンドウに関する関数 


CreateStatusWindow 

ステータスウィンドウ作成 

78 

DrawStatusText 

ステータスウィンドウテキスト描闽 

78 

MenuHelp 

ステータスウィンドウヘルプ表示 

80 


•Toolbar :ツールバーオブジ i クトに関する関数 


CreateMappedBitmap 

ツールバービットマップ作成 

81 

CreateToolbarEx 

ツールバーボタン作成 

82 
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付録 A 機能別 API —！！ 


• Up-Down Control : アップダウンコントロールに関する関数 


CreateUpDownControl 

アップダウンコントロール作成 

84 

• Button : ボタンコントロールの操作と管理に関する関数 


CheckDlgButton 

チェックマークを f 十けるかまたは取り除く、 3 ステートボタンのときは 
その状態を変史する 

85 

Check Radio Button 

指定されたオプションボタンを迸択して、そのほかをすべてのボタンを 
进択解除する 

86 

IsDlgButtonChecked 

ボタンが逸択されているかどうかを調べる 

87 


• Combo Box : コンボボックスコントロールに関する関数 


DlgDirUstComboBox 

パス名と一致するファイルの名前をコンボボックス内に一 1 ¢1 衣ボする 

88 

DlgDirSelect 

リストボックスから祝在の迸択項 H を文字列バッファにコピーする 

90 

DlgDirSelectComboBox 

コンボボックスからの迸択項 U を义字列ノしソファにコピーする 

91 


• Dialog Box : ダイアログウィンドウに関する関数。 


CreateDialog 

モードレスダイアログボックスを作成する 

92 

DefDlgProc 

アプリケーションで定義されたダイアログボックスプロシージャが処理 
しないメッセージに対して、デフオルト処押を行う 

93 

DialogBox 

モーダルダイアログボックスを作成する 

94 

DialogProc 

モードレスダイアログボックスに送られるメッセージを処する 

95 

EndDialog 

リソースを解放して、モーダルダイアログボックスに閲迚付けられてい 
るウィンドウを破焚する 

96 

GetDialogBascUnits 

ダイアログボックスベース啉位取得 

97 

GetDlgCtrllD 

コントロールウィンドウの•裁別子を返す 

98 

GetDlgltem 

衍定されたダイアログボックス内のダイアログボックスコントロールの I 

ハンドルを取得する 

98 

GetNextDlgGroupItem 

グループ内の次または前の項目のウィンドウハンドルを返す 

99 

GetNextDlgTabltem 

次または前の拟 11 の WS_TABSTOP コントロールを返す 

100 

IsDialogMessage 

指定されたモードレスダイアログボックスのためのメッセージであるか 
どうかを利断する 

101 

MapDialogRect 

ダイアログボックス咻位変換 


MessageBox 

指定されたテキストとタイトル、アイコンを持つメッセージウィンドウを 
作成する 


MessageBoxIndirect 

メッセージ榊造体からメッセージウィンドウを作成する 

109 

SendDlgltemMessage 

ダイアログボックス内のコントロールにメッセージを送る 

106 

SetDlgltemlnt 

コントロールのタイトルまたはテキストを整数侦で表された文字列に股定 
する 

107 

SetDlgltemText 

コントロールのタイトルやテキストを t 没定する 

108 
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付 録 


#Edit Control ••テキストの入行を行うエディットコントロールオブジェクトに関する関数。 


EditWordBreakProc 

エディットコントロールテキスト編迅 

110 

• List Box : 複数の値から 

一覧を選択するリストボックスコントロールに関する関数。 


DlgDirList 

リストボックスに、バスと 致する ファイルの お前をでぶ ポ •する 

111 

DlgDirSelectEx 

リス ト ボックス 逸択项 H 取得 

113 


• Scroll Bar :スクロールバーの操作と管理に関する関数 


EnableScrollBar 

スクロールバー 状態 設定 

114 

GetScrollPos 

スクロールボックスの現在の位 irt を取得する 

115 

GetScroll Range 

指定されたスクロールバーの、位趵の W 人敝と « 小(を取得する 

116 

ScrollDC 

H 力•形を水、1 ' : 力 M または啦 め : 力•向にスクロールする 

118 

ScrollWindow 

クライアント領域の内容を移 勅す る 

119 

SetScrollPos 

スクロールボックス の讎を 設定する 

121 

SetScrollRange 

スクロールバーの、位！! v (の敁大姑:と W 小(を，没定する 

122 

ShowScrollBar 

スクロールバーとそのコントロールをぶ示したり非衣,〗;•にしたりする 

124 

• Control Panel : コントロールバネル操作の関数。 

CPIApplet 

コントロールパネル DLL のメッセージを処理する 

125 

• File Installation Library :ファイルインストール機能を提供する関数。 

GetFileVersionlnfo 

指定されたファイルにするバージョン 怙報を 返す 

126 

GetFileVersionlnfoSize 

ファイルのバージョン怡報のサイズを返す 

127 

VerFindFile 

インストール位! W 利 定 

128 

VerlnstallFile 

ファイルインストール 


VerLanguageName 

言恕識 別子変換 

134 

VerQueryValue 

バージョンリソース内容取 jy 



• Screen Saver :スクリーンセーバー操作と管理に関する関数 


DefocreenSaverProc 

デフオルトのスクリーンセーバーウィンドウプロシージャを呼び出す 

137 

RegisterDialog し lasses 

スクリーンセーバーのダイアログボックスのクラスを a 鉍する 

139 

ScreenSaverConfigureDialog 

股定⑴ダイアログボックスのメッセージを処邱する 

140 

ScreenSaverProc 

スクリーンセーバーのウィンドウメッセージを処理する 

141 
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付録 A 機能別 API—K 


• Shell Library :シェル上でのユーザーの操作をアプリケーションに伝える 


DragAcceptFiles 

ウィンドウがドロップされるファイルをウィンドウが受け取れるかどうか 
を示す trt 報を登鉍する 

142 

DragFinish 

ドロップファイル⑴に剂り当てられたメモリを解放する 

142 

DragQueryFile 

ドロップファイルの名前を取得する 

143 

DragQueryPoint 

ファイルがドロップされたときのマウスの位竹を取拊する 

144 

ExtractAssociated Icon 

ファイル、または 閲迚 •けられた艾行" j 能 ファイルから、アイコンハンド 
ルを 取得 

145 

Exlractlcon 

火行" j 能 ファイルからアイコンのハンドルを 取 w 

146 

FindExecutable 

プログラムファイルのためのファイル名とその ハン ドルを取以 

147 

ShellAbout 

Windows が捉供するバージョン怡報のダイアログボックスを衣 / J •く 

148 

ShellExecute 

指定されたファイルをオープンまたはぶ示 

149 

• Bitmap : Windows 標準形式のビットマップオブジェクト操作に関する関数 

BitBlt 

デバイスコンテキスト問でビットマップをコピー 

153 

CreateBitmap 

デバイスに依存するメモリビットマッブを作成 

155 

CreateCompatibleBitmap 

指定されたデバイスと互換性のあるビットマップを作成する 

156 

CreateDIBitmap 

DIBU: 様のビットマップからビットマップのハンドルを作成する 

157 

ExtFloodFill 

祝 /! •:のブラシ で脈 を硪りつぶす 

■^1 

FloodFill 

fli/K のブラシで頟域を•後りつぶす 

160 

GetBitmapBits 

指定されたビットマップのメモリ内のビットを取以する 

161 

GetBitmapDimensionEx 

ビットマップの幅と W さを取拊 

162 

GetDIBColorTable 

RGB カラー 姑 : の Mm 

163 

GetDIBits 

CopiesDIB のビットをバッファにコピーする 

164 

GetPixel 

指定されたピクセルの RGB カラー W を取拊 

166 

GetStretch Bit M ode 

祝 /K の 仲縮 モードを 取 W する 

167 

Load Bitmap 

ビットマッブリソースをロー ドする 

167 

SetBitmapBits 

ビット W 列からビットマップビットを設定 

169 

SetBitmapDimensionEx 

ビットマップの幅と! fS さを設定 

170 

SetDIBColorTable 

ビットマップからカラー•设定 

171 

SetDIBits 

ビットマップのビットを設定する 

172 

Set DI BitsToDevice 

デバイスに DIB のビットを設定する 

173 

SetPixel 

ピクセルの RGBW を•没定する 

175 

SetPixelV 

ピクセルを指定された色に設定 

176 

SetStretchBltMode 

仲縮 モードを 113 定する 

177 

Stretch Bit 

コピーノ C からコピー先のデバイスにビットマップを拡人. 縮小 コピーする 

178 

Stretch DI Bits 

送元から杈送先の K 方形に DIB を送する 

180 
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付 録 


• Brush :グラフィックを塗りつぶす際に利用するブラシオブジェクトに関する関数 


CreateBrusnlndirect 

BITMAP 構造体を使ってビットマップを*ボ • 

182 

Create !) I BPattern Brush 

デバイスに \ ti { f しないビットマップ ( DIB : Device ~ IndependentBitmap ) によ 
り定義されるパターンの論押ブラシを作成する 

183 

CreateDIBPatternBrushPt 

ビットマップから说ブラシを作成 | 

184 

CreateHatchBrush 

ハッ チパターンの，设理ブラシを作成する 

185 

Create Pattern Brush 

メモリビットマップ ( DIB ) により定義されるパターンの,设理ブラシを作成 
する 

186 

CreateSolidBrush 

衍定された色を持つ純色のブラシを作成 

187 

GetBrushOrgEx 

現 / K のブラシの fii 点を取得 • 

188 

GetSysColorBrush 

論押ブラシハンドル取 W 

189 

SetBaishOrgEx 

祝 / f •のブラシの点を,1¢定 

189 


• Clipping :クリツビング操作に関する関数 


ExcludeClipRect 

クリッビングリージョンを変汜して及力•形を取り除く 

191 

ExtSelectClipRgn 

リージョンをクリッピングリージョンとして迸択 

192 

GetClipBox 

クリッビングリージョンを！; U む兑力•形を取以 

193 

GetClipRgn 

况 ft のクリッビングリージョンを返す 

194 

GetMetaRgn 

祝/！*:のメタリージョンを返す 

195 

IntersectClipRect 

クリッピングリージョンと於/；•形との交わりを作成する 

196 

OffsetClipRgn 

クリッビングリージョンを移勁する 

197 

Pt Visible 

指定された点が指定されたリージョン内にあるかどうかを, M ベる 

198 

RectVisible 

及方形の.部が指定されたリージョン内にあるかどうかを調べる 

198 

SelectClipPath 

祝 / K のパスをクリッビングリージョンとして迸択 

199 

SelectClipRgn 

クリッビングリージョンを达択する 

200 

SetMetaRgn 

クリッビングリージョンをメタリージョンとして进択 
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付録 A 機能別 API — 蓖 


• Color :ユーザーインターフェイス用に利用される色に関する関数 


AnimatePalette 

論理パレットのエントリを! W き换える Windows は、新しいエントリを 
システムパレットに即座に； W り当てる 

202 

CreateHalftonePalette 

デバイスコンテキストのための ハーフ トーンパレットを作成 

203 

CreatePalette 

論 fl ! カラーパレットを作成 

204 

GetColorAdjustment 

デバイスコンテキストに対する色调粮を取得 

205 

GetNearestColor 

利用可能な K も近い色を取得 

206 

GetNearestPalettelndex 

指定の色に W も近いインデックスを取得 

207 

GetPaletteEntries 

翁理パレットからエントりを取得する 

208 

GetSystemPaletteEntries 

指定された範 M のパレットエントリをシステムパレットから収以する 

209 

GetSystemPaletteUse 

アプリケーションがシステムパレット令体にアクセスできるかどうかを 

210 


利浙する 


RealizePalette 

論理パレットのエントリをシステムパレットに別り3てる 

211 

ResizePalette 

指定されたぬ理パレットのサイズを変史する 

212 

SelectPalette 

論理パレットをデバイスコンテキストの中に逍択する 

213 

SetColorAdjustment 

デバイスコンテキストに対する色の调粮 tfi : を股定 

214 

SetPaletteEntries 

•泣理パレットに新しいパレットエントリを•没定する 

215 

SetSy stem PaletteUse 

アプリケーションがシステムパレット全体にアクセスできるようにする 

216 

UnrealizeObject 

衍定されたブラシの W 点をリセットするように GDI に指ぶ•する 

218 

UpdateColors 

クライアント祐域内の色を史新 

219 





































付 録 


參 Coordinate Space and Transformation :グラフイックの座標系に関する各種の操作と管理を行う関数 


ClientToScreen 

クライアント座 BS をスクリーン座標に変換 

220 

Combine ! ransform 

2つの降控変換を結合 

221 

DPtoLP 

デバイス座抒卜.の段数の点(ウィンドウの W 点からの fll 対位! rt ) を,朵邱崦 
標点に変換する 

222 

GetCurrentPositionEx 

位竹を说理#位で取价 

223 

GetDeviceCaps 

ディスプレイデバイスの固打怡報を取辩 

223 

GetGraphicsMode 

衍定されたデバイスコンテキストに対するグラフィックスモードを取以 

230 

GetMapMode 

fli /卜:のマッピングモードを取得する 

231 

GetViewportExtEx 

ビューポートの範州を取以 

232 

GetWindowExtEx 

ウィンドウの範 W を取 fl # 

233 

GetWorldTransfomi 

ワールド乍間からベージ空 W ] への変換の取以 

234 

LPtoDP 

論 nmR 点をデバイス座控点に変換する 

235 

MapWindowPoints 

座点をほかの座標系に変換する 

236 

ModifyWorldTransform 

现 / t のワールド座標変換を変史 

237 

Offset ViewportOrgEx 

ビューポートの松点を移動 

238 

OffsetWindowOrgEx 

ウィンドウの点を移！ K ; 

239 

Scale Vi ewpo rt Ext Ex 

ビューポートの範洲をスケーリング 

240 

ScaleWindowExtEx 

ウィンドウの範 M をスケーリング 

241 

ScreenToClient 

指定されたディスプレイ上の点のスクリーン崦挖をクライアント崦 ft に 
変换する 

242 

SetGraphicsMode 

指定されたデバイスコンテキストに対するグラフィックスモードを,设定 

242 

SetMapMode 

衍定されたデバイスコンテキストのマッピングモードを,设定する 

244 

SetViewportExtEx 

ビューポートの範叫を•没定 

246 

SetWindowExtEx 

ウィンドウの範 M を•没定 

247 

Set W orldT ransfomi 

祝/ I •:のワールド座 K 変換を,没定 

248 
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付録 A 機能別 API —覧 


CreateEnhMetaFile 

拡張メタファイル DC を作成 

266 

CreateMetaFile 

メタファイルのデイスプレイコンテキストを作成する 

267 

GetEnhMetaFile 

拡張メタファイルを作成 

268 

GetMetaFile 

Windows メタファイルを作成 

269 


Ellipse 

だを描 _ する 

254 

FillRect 

指定のブラシを使用して、指定された良方形を磺りつぶす 

255 

Pie 

W 形を描する 

256 

Polygon 

多州形を描幽する 

257 


• Device Context :テバイスコンテキストに関する関数 


ChangeDisplay^ettings 

ディスプレイの,没定を変 5! する 

249 

CreateDC 

デバイスコンテキストを作成する 

251 

DeleteDC 

デバイスコンテキストを削除する 

252 

GetDC 

クライアント如域のデバイスコンテキストを取得する 

253 


• Filled Shape :塗りつぶされた図形描画に関する関数 


• Path :バスに関する関数 


BeginPath 

パスのブラケットを間始 

270 

Closer igure 

パス中の図形をクローズ 

271 

EndPath 

パスのブラケットを終 r 

271 

GetPath 

パス内のすべてのめ:線と曲線を返す 

272 

PathToRegion 

パスからリージョンを作成 

273 


• Font and Text :テキスト出力操作とフォント操作に関する関数 


DrawText 

式化されたテキストを鉍方形内に描両する 

258 

GetAspectRatioUlterEx 

現在のアスべクト比フィルタを取得する 

260 

GetFontData 

TrueType フォントファイルから、フォントメトリックデータを取价する 

261 

PolyTextOut 

抅数の文字列を描く 

262 

SetTextAlign 

テキスト义字列をデバイスやディスプレイにする 

263 

SetTextColor 

テキストの色を•设定する 

264 

TextOut 

fli/E のフォントを使 H1 して、文字列をき込む 

265 


• Metafile : メタファイルグラフィックスに関する関数 
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付 録 


• Region :リージョンとその操作に関する関数 


FillRgn 

衍定されたリージョンをブラシパターンで後りつぶす 

274 

GetRgnBox 

リージョンの境界及方形の座標を取得する 

275 

PaintRgn 

透択されているブラシパターンでリージョンを飱りつぶす 

275 

•Accessibility : Windows システム情報に関する関数 

GetSystemMetrics 

システム メトリックに問する怙報を取得する 

276 


• Data Decompression Library I 圧縮フアイル操作に関する関数 


LZClose 

ファイルをクローズする 

280 

LZCopy 

ファイルをコピーして圧縮されていればそれを展開する 

281 

LZOpenFile 

U: 縮および非 li: 縮のファイルをオープンする 

282 


• Error : Windows システムから返される各種のエラー処理に関する関数 


Beep 

ビープを発牛 

284 

ExitWindows 

Windows を シャツ トダウンする 

285 

GetLastError 

tf 太张エラーコード を返す 

286 


籲 Re :ファイルの入出力操作に関する関数 


CopyFile 

ファイルをコピー 

287 

GetCurrentDirectory 

プロセスの祝在のディレクトリを返す 

288 

GetDiskr reeSpace 

空きディスク衫はの総«を返す 

289 

GetFileAttributes 

ファイル w 性を返す 

290 

GetFileSize 

衍定されたファイルのサイズを返す 

291 

GetFileType 

指定されたファイルの神類を返す 

292 

GetFullPathName 

ファイル名のパス名を取得 

293 

LockFile 

ファイルをロツクする 

294 

MoveFile 

ファイル名を変史 

295 

Read File 

ファイルから読み取る 

296 

RemoveDirectory 

既存のディレクトリを除去 

297 


參 Help : Windows ヘルプの操作と管理に関する関数 


GetMenuContextHelpId 

メニューコンテキストヘルプ ID を取得する 

298 

GetWindowContextHelpId 

ウインドウコンテキストヘルプ ID を取する 

298 

WinHelp 

Windows ヘルプアプリケーションを起勁し、コンテキスト怡報やトビッ 
ク怡報を渡す 

298 
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付録 A 機能別 API —覧 


Loadlmage 

リソースからビットマップイメー ジを ロードする 

322 

LoadResource 

リソースを口ー ドする 

324 


RegCreateKey 

キーを作成またはオーブン 

319 

RegDeleteKey 

キーを削除 

320 

RegSetValue 

指定されたキーにテキスト文字列を閲迚忖ける 

321 


• Resource :リソース操作に関する関数 


ConnectNamedPipe 

クライアントが接絞するのを待つ 

306 

CreateNamedPipe 

f, きパイプのインスタンスを作成 

306 

CreatePipe 

名 rttf なしパイプを作成 

309 

DisconnectNamedHpe 

名前はきパイプのサーバー端点との接絞を解除 

310 


# Process and Thread :プロセスとスレツド処理に関する関数 


CreateProcess 

祈しいプロセスオブジェクトおよびスレッドオブジェクトを作成 

311 

CreateThread 

新しいスレッドを作成 

314 

Get し urrentProcess 

祝在のプロセスを識別するハンドルを返す 

316 

GetCurrentThread 

%在のスレッドを•裁別するハンドルを返す 

316 

WinExec 

ほかのアプリケーションを实行する 

317 


參 Registory :レジストリデータベース処理に関する関数。 


• String Manipulation :文字列操作を実行する関数 


CharNext 

文字列内の次の文字に移! R/J 

324 

CharUpper 

1 文字または文字列を人文字に変換 

325 

CompareStnng 

2 つの文字列を比較 

325 

FormatMessage 

メッセージ文字列の形式を設定 

327 

GetTimeFormat 

時間文字列を取得 

329 

LoadString 

文字列リ ソースを ロー ドす る 

331 

MultiByteToWideChar 

マルチバイト 文字列を ワイ ド文字の文字列に マップ 

332 


• Memory Manaaement : Windows で利用されるメモリの操作と管理に関する関数 


GlobalAlloc 

グローバルヒープからメモリを沏り当てる 

301 

HeapAlloc 

ヒープからメモリを; 1 } u り当てる 

302 

Ix)calAlloc 

ローカルヒープからメモリを削り当てる 


VirtualAlloc 

指定範 w の仮想ページを予約 

304 

ZeroMemory 

メモリブロックの内容をすべて 0 にする 

305 


• Pipe :名前付きおよび名前無しパイプ処理に関する関数 
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付 録 


參 Structured Exception Handling : 構造化例外処理に関する関数 


AbnormalTerminauon 

try - finally の状態を返す 

334 

GetExcepuoncode 

例外の神頌を返す 

334 

GetExceptionlmormation 

例外の詳細怡報を返す 

336 

Raise 匕 xception 

例外を起こす 

336 

SetUnhandledExceptionFilter 

既存のものに代わるフィルタ例外 ra 数を,设定 

337 

UnhandledExceptionFilter 

アプリケーションへの例外をフィルタする 

338 


• System Information : 口ーカルコンピュータ固有の情報の取得に関する関数 


GetComputerName 

現 / K のコンピュータ名を取得 

339 

GetSystem Info 

のシステム ti * f 報を返す 

339 

GetUserName 

ユーザー名を返す 

340 

GetVersion 

Windows のバージョン怡報を取料する 

341 

GetWindowsDirectory 

Windows ディレクトリのパスを収する 

342 


•Time : 日付と時刻に関する関数 


Comparer lie rime 

2 つの 64 ビッ トのファ イ ル 時問を比較 

343 

FileTimeToSystemTime 

64ビット形式の時間をシステム時問に変換 

344 

GetSystemTime 

システムの 時刻と11付を返す 

344 


參 Window Station and Desktop : Windows システムのデスクトップ操作に関する関数 


CreateDesktop 

ウィンドウステーションに訢规デスクトップを作成する 

345 

CreateWindowStation 

新規のウィンドウステーションを作成する 

346 

GetProcessWindowStation 

ブロセスのウインドウステーションハンドルを返す 

348 

SwitchDesktop 

デスクトップを交換する 

348 
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付録 B アルファベット順 API —覧 


付録 B アルフアベツト順 API —覧 


本害の「第2章 Win 32 API リファレンス J で説明している API 関数を関数名のアルファベット顒 
に並べ替え、 API 関数名、機能、掲載ページをまとめた一 K 表を以下に掲載する0機能別の API — 
K は、「付録 A 機能別 API — KJ を#照してもらいたい。 


API 関数 

概 要 

ページ 

AbnormalTermination 

try-finally の状態を返す 

334 

Add Props hcct Page Proc 

ブロパティシートページ迫加 

73 

AdjustWindowRect 

指定されたクライアント锨域に合うように、ウィンドウのサイズをする 

28 

AnimatePalette 

論押パレットのエントリを趵き換える Windows は、新しいエントリをシステム 
パレットに即座に割り当てる 


ArrangelconicWindows 

アイコン化されたウィンドウを整列する 

52 

Beep 

ビープを発生 

284 

BeginPaint 

描_処邱のためにウィンドウを增備する 

58 

BeginPath 

パスのブラケットを間始 

270 

BitBlt 

デハ•イスコンテキスト問でビットマップをコピー 

153 

ChangcDisplayScttings 

ディスプレイセッティングの変 5 {をする 

294 

CharNext 

文字列内の次の文字に移勋 

324 

CharUpper 

1 文字または文字列を火文字に変換 

325 

CheckDIgButton 

チェックマークを f 、 J* けるか、または取り除く 3 ステートボタンのときは、その状 
態を変史する 

85 

CheckRadioButton 

指定されたオプションボタンを逍択して、そのほかをすべてのボタンを迸択解除 
する 

86 

ChooseColor 

色を透択するためのダイアログボックスを作成する 

40 

ChooseFont 

フォント を进 iK するための ダイアログボックスを作成する 

41 

ClientToScrccn 

クライアント座標をスクリーン座標に変換 


CloseClipboard 

クリップボードをクローズする 

38 

Closcngurc 

パス中の図形をクローズ 

271 

CombineTransform 

2 つの座抒変換を結合 

221 

ComparcFilcrimc 

2 つの 64 ビットのファイル時冏を比較 

343 

CompareString 

2 つの文字列を比較 

325 

ConnectNamcdPipc 

クライアントが接校するのを待つ 

306 

CopyFile 

ファイルをコピー 

287 

CPIApplet 

コントロールパネル DLL のメッセージを処砰する 

125 

CrcatcBitmap 

デバイスに依存するメモリビットマップを作成 

155 

CreateBrushIndirect 

BITMAP 榊造体を使ってビットマップを表示 

182 

CreateCaret 

キヤレットを作成する 

36 
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API 関数 

概 要 

ページ 

CreateCompatibleBitmap 

指定されたデバイスと互換性のあるビットマップを作成する 

156 

CreateCursor 

2つのビットマスクからマウスカーソルを作成する 

48 

CreateDC 

デバイスコンテキストを作成する 

251 

CreateDesktop 

ウィンドウステーションに新规デスクトップを作成する 

345 

CreateDialog 

モードレスダイアログボックスを作成する 

92 

CreateDIBitmap 

DIB 仕様のビットマップからビットマップのハンドルを作成する 

157 

CreateDIBPattemBrush 

デバイスに依存しないビットマッブ ( DIB : Device - IndependentBitmap ) により定義さ 
れるパターンの淪理ブラシを作成する 

183 

CreateDIBPattemBrushPt 

ビットマップから論理ブラシを作成 

184 

CrcatcEnhMctaFilc 

拡张メタファイル DC を作成 

266 

CreateHalftonePalette 

デバイスコンテキストのためのハーフトーンパレットを作成 


CreateHatchBrush 

ハッチパターンの論理ブラシを作成する 

185 

CreatelconFromResource 

アイコンリソースからアイコンを作成する 

53 

CreateMappedBitmap 

ツールノ《ービットマップ作成 

81 

CreateMetaFile 

メタファイルのディスプレイコンテキストを作成する 

267 

CreateNamedPipe 

名前付きパイプのインスタンスを作成 

306 

CreatePalette 

論理カラーパレットを作成 

204 

CreatcPattcrnBrush 

メモリビットマップ ( DIB >により定義されるパターンの論理ブラシを作成する 

186 

CreatePipe 

名前なしパイプを作成 


CreateProcess 

新しいプロセスオブジェクトおよびスレッドオブジェクトを作成 

311 

CreatePropcrtySheetPage 

新规プロパティシートページ作成 

74 

CreateSolidBrush 

指定された色を持つ純色のブラシを作成 

187 

CrealeStatusWindow 

ステータスウィンドウ作成 

78 

CreateThread 

新しいスレッドを作成 

314 

CreateToolbarEx 

ツールバーボタン作成 

82 

CreateUpDownControl 

アップダウンコントロール作成 

84 

CreateWindow 

オーバラップウィンドウ、ポップアップウィンドウ、子ウィンドウを作成する 

29 

CreateWindowStation 

新規のウィンドウステーションを作成する 

346 

DetDIgProc 

アプリケーションで定義されたダイアログボックスプロシージャが処理しない 
メッセージに対して、デフオルト処理を行う 

93 

DefSereenSaverProc 

デフオルトのスクリーンセーバーウィンドウプロシージャを呼び出す 

137 

DeleteDC 

デバイスコンテキストを削除する 

252 

DestroyPropcrtyShcetPage 

プロパティシートページ破焚 

74 

DestroyWindow 

ウィンドウを破索する 

32 

DialogBox 

モーダルダイアログボックスを作成する 

94 

DialogProc 

モードレスダイアログボックスに送られるメッセージを処理する 

95 

DisconnectNamcdPipc 

名前 付 きパイプのサーノ、•一端点との 接続を 解除 

310 

DispatchMcssage 

スクリーンセーバーのノ《スワードを変 1 ii •する 

54 
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付録 B アルファベット順 API—JI 


API 関数 

概 要 

ページ 

DlgDirList 

リストボックスに、パスと -•致するファイルの名前を 一？!表示する 

111 

DIgDirListComboBox 

パス名と一致するファイルの名前をコンボボックス内に 一 K 表示する 

88 

DlgDirSelect 

リストボックスから Si / K の迸択泊目を文字列ノ、•ッファにコピーする 

90 

DlgDirSelectComboBox 

コンボボックスから現在の速択項目を文字列ノヽ*ッファにコピーする 

91 

DIgDirSelectEx 

リストボックス遗択泊 b 取汾 

113 

DPtoLP 

デバイス嵴挖卜.の複数の点(ウィンドウの®点からの扪対位听)を論理崦標点に変 
換する 

222 

DragAcceptFiles 

ウィンドウがドロップされるファイルをウィンドウが受け取れるかどうかを示す 
情報を《録する 

142 

DragFinish 

ドロップファイル用に; 1 pj り当てられたメモリを解放する 

142 

DragQueryFile 

ドロップファイルの名前を取得する 

143 

DragQueryPoint 

ファイルがドロップされたときのマウスの位趵を取得する 

144 

DrawAnimatedRccts 

アニメーション描两 i 領域を作成する 

59 

Drawlnsert 

アイコン描 

72 

DrawStatusText 

ステータスウィンドウテキスト描幽 

78 

DrawText 

M 式化されたテキストを反方形内に描_する 

258 

EditWordBreakProc 

エディットコントロールテキスト編 


Ellipse 

だ H を描 rt する 

254 

EmptyClipboard 

クリップボードを空にし、クリップボードの所打権を洱度剂り当てる 

39 

EnableScrolIBar 

スクロールバー状態,没定 

114 

EndDialog 

リソースを解放して、モーダルダイアログボックスに閲迚忖けられているウィン 
ドウを破褒する 

96 

EndPath 

パスのブラケットを終了 

271 

ExcludeClipRect 

クリッピングリージョンを変®して鉍//形を取り除く 

191 

ExitWindows 

Windows をシャットダウンする 

285 

ExtensionPropShcetPageProc 

ブロパティシート拡張 

75 

ExtFloodFill 

|现 / E のブラシで領域を硪りつぶす 

159 

Extract Associatedlcon 

ファイル、または閲迚 f 十けられた実行可能ファイルから、アイコンハンドルを取得 

145 

Extracticon 

実行可能ファイルからアイコンのハンドルを取扮 

146 

ExtSelectClipRgn 

リージョンをクリッピングリージョンとして透択 

192 

FileTimeToSystemTime 

64ビット形式の時間をシステム時間に変換 

344 

FillRect 

指定のブラシを使川して、指定された方形を'塗りつぶす 

255 

FillRgn 

指定されたリージョンをブラシパターンで绝りつぶす 

274 

FindExecutable 

プログラムファイルのためのファイル名とそのハンドルを取得 

147 

FindText 

テキストを検索するためのダイアログボックスを作成する 

42 

FormatMessage 

メッセージ文字列の形式を設定 

327 

GetAspectRatioFilterEx 

卜 :のアスべク ト比フィルタを取以する 

260 

FloodFill 

現在のブラシで領域を塗りつぶす 

160 
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API 関数 

概 要 

ページ 

GetBitmapBits 

指定されたビットマップのメモリ内のビットを取得する 

161 

GetBitmapDimensionEx 

ビットマップの幅と高さを取得 

162 

GetBrushOrgEx 

現在のブラシの原点を取得 

188 

GetCaretPos 

現在のキャレットの位 8 R を返す 

37 

GetClassInfo 

ウィンドウクラス怙報を取得する 

66 

GetClipboardData 

クリップボードからデータを取得する 

39 

GetClipBox 

クリッピングリージョンを叫む於方形を取得 

193 

GetClipRgn 

稅在のクリッビングリージョンを返す 

194 

GetColorAdjustment 

デバイスコンテキストに対する色調粮を取得 


GetComputerName 

说在のコンピュータ名を取汾 

339 

GetCurrentDirectory 

プロセスの現在のディレクトリを返す 

288 

GctCurrcntPositionEx 

位趵を猞理単位で取得 

223 

GetCurrentProcess 

祝在のプロセスを識別するハンドルを返す 

316 

GetCurrentThread 

祝在のスレッドを識別するハンドルを返す 

316 

GetCursorPos 

マウスカーソルの位趵を （ スクリーン座標で)取?、#する 

49 

GetDC 

クライアント領域のデバイスコンテキストを取得する 

253 

GetDcviceCaps 

ディスプレイデバイスの凼有怙報を取得 

223 

GetDialogBaseUnits 

ダイアログボックスベース啉位取 ft ) 

97 

GetDIBColorTable 

RGB カラー侦の回拟 

163 

GetDIBits 

CopiesDIB のビットをバッファにコピーする 

164 

GetDiskFreeSpace 

空きディスク容«の総 W を返す 

289 

GetDIgCtrllD 

コントロールウィンドウの識別子を返す 

98 

GetDlgltem 

指定されたダイアログボックス内のダイアログボックスコントロールのハンドル 
を取得する 

98 

GetEffectiveClientRect 

クライアント領域矩形範 M 扑兑 

70 

GetEnhMetaFile 

拡張メタファイルを作成 

268 

GetExceptionCode 

例外の M 頌を返す 

334 

GetExceptionlnformation 

例外の詳細怙報を返す 

336 

GetFileAttributes 

ファイル W 性を返す 

290 

GetFileSize 

指定されたファイルのサイズを返す 

291 

GetFileTitle 

ファイル名を取得 

43 

GetFileType 

指定されたファイルの神類を返す 

292 

GetFileVersionlnfo 

指定されたファイルに問するバージョン怡報を返す 

126 

GetFileVersionInfoSize 

ファイルのバージョン怡報のサイズを返す 

127 

GetFullPathName 

ファイル名のパス名を取得 

293 

GetGraphicsMode 

指定された DC に対するグラフィックスモードを取得 

230 

Get し astError 

拡張エラーコードを返す 

286 
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付録 B アルファべット順 API—K 


API 関数 

概 要 

ページ 

GetFontData 

TrueType フォントファイルから、フォントメトリックデータを取する 

261 

GetMapMode 

現在のマッピングモードを取得する 

231 

GetMenuContextHelpId 

メニューコンテキストヘルプ ID を取得する 

298 

GetMessage 

アプリケーションのメッセージキューからメッセージを取 fU する 

55 

GetMetaFile 1 

Windows メタファイルを作成 

269 

GetMetaRgn 

现 / f のメタリージョンを返す 

195 

GetNearestColor 

利可能な W も近い色を取得 

206 

GctNcarestPalettelndex 

指定の色に iii も近いインデックスを取得 

207 

GetNextDlgGroupItem 

グルーブ内の次または前の泊 H のウィンドウハンドルを返す 

99 

GetNextDlgTabltcm 

次または前の項ほの WS . TABSTOP コントロールを返す 

100 

GetOpenFileName 

ファイルをオープンするためのダイアログボックスを作成する 

43 

GetPaletteEntries 

論理パレットからエントリを取得する 

208 

GetPath 

パス内のすべての線と曲線を返す 

272 

GetPixel 

指定されたピクセルの RGB カラ ー W を取得 

166 

GetProcessWindowStation 

プロセスのウィンドウステーションハンドルを返す 

348 

GetProp 

プロパティリストを取得する 

68 

GetRgnBox 

リージョンの境界鉍方形の座標を取得する 

275 

GetSaveFileName 

ファイルを保存するためのダイアログボックスを作成する 

44 

GetScrollPos 

スクロールボックスの現在の位!«を取得する 

115 

GetScrollRange 

指定されたスクロールノ、•一の、位竹の W 人的と M 小 W を取拊する 

116 

GetStretchBItMode 

祝在の仲縮モードを取得する 

167 

GetSysColorBrush 

論理ブラシハンドル取得 

189 

GetSystemlnfo 

現在のシステム怙報を返す 

339 

GetSystemMetrics 

システムメトリックに問する W 報を取得する 

276 

GetSystemPaletteEntries 

指定された範 W のパレットエントリをシステムパレットから取得する 

209 

GetSystemPalctteUse 

アブリケーションがシステムパレット全体にアクセスできるかどうかを利断する 

210 

GetSystemTime 

システムの時刻と卜1付を返す 

344 

GetTimeFormat 

時問文字列を取得 ! 

329 

GetUserName 

ューザー名を返す 

340 

GetVersion 

Windows のバージョン怙報を取 flf する 

341 

GetVicwportExtEx 

ビューポートの範 W を取以 i 

232 

GetWindow 

ウィンドウハンドルを取得する 

33 

GetWindowContextHelpld 

ウィンドウコンテキストヘルプ ID を取得する 

298 

GetWindowExtEx 

ウィンドウの範阅を取得 

233 

Get Wi ndowsDi rectory 

Windows ディレクトリのパスを取得する 

342 

GetWindowTexl 

ウィンドウタイトルをバッファにコピーする 

34 

GetWorldTransform 

ワールド空問からページ空問への変換の取得 

234 
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API 関数 

概 要 

ページ 

GetWindowRect 

ウィンドウ全体の寸法を取する 

34 

GlobalAlloc 

グローバルヒープからメモリを割り当てる 


HeapAlloc 

ヒープからメモリを剤り当てる 

302 

HideCaret 

指定されたウィンドウからキヤレットを削除する 

38 

InitCommonControIs 

コモンコントロール DLL 確立 

71 

IntersectClipRect 

クリッピングリージョンと鉍方形との交わりを作成する 

196 

IntersectRect 

出描_のための M 方形をマークする 

62 

IsDialogMessage 

指定されたモードレスダイアログボックスのためのメッセージがであるかどうか 
を利断する 


IsDlgButtonChecked 

ボタンが逍択されているかどうかを, IW ベる 

87 

KillTimer 

指定されたタイマーイベントを削除する 

64 

LBItemFromPt 

リスト項 B インデックス検出 

72 

LoadBitmap 

ビットマッブリソースをロードする 

167 

LoadCursor 

マウスカーソルリソースをロードする 

49 

LoadCu rsorFrom Fi le 

ファイルからカーソルリソースをロー ドする 

51 

Loadlmage 

リソースからビットマップイメージを口ー ドする 

322 

Load Resource 

リソースをロー ドする 

324 

LoadString 

文字列リソースをロー ドする 

331 

LocalAIIoc 

ローカルヒープからメモリを沏り当てる 

303 

LockFile 

ファイルをロックする 

294 

LPtoDP 

論理嵴挖点をデバイス座標点に変換する 

235 

LZCIose 

ファイルをクローズする 


LZCopy 

ファイルをコピーしてぼ縮されて t ゝればそれを展開する 

281 

LZOpenFile 

圧縮および非縮のファイルをオープンする 

282 

MakeDragList 

ドラッグリストボックス作成 

73 

MapDialogRect 

ダイアログボックス啉位変換 


MapWindowPoints 

座挖点をほかの座抒系に変換する 

236 

MenuHelp 

ステータスウィンドウヘルプ表示 

80 

MessageBox 

指定されたテキストとタイトル、アイコンを持つメッセージウィンドウを作成する 

103 

MessageBoxIndirect 

メッセージ構逍体からメッセージウィンドウを作成する 

109 

McxIifyWorldTransform 

現在のワールド座標変換を変史 

237 

MoveFile 

ファイル名を変史 

295 

Move Window 

ウィンドウのサイズと位趵を変更する 

35 

MultiByteToWideChar 

マルチバイト文字列をワイド文字の文字列にマップ 

332 

OffsetRect 

指定された畏方形を移動する 

63 

Offset V iewportOrgEx 

ビューポートの原点を移動 

238 

OffsetWindowOrgEx 

ウィンドウの原点を移動 

239 
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付録 B アルファべット順 API —!! 


API 関数 

概 要 

ページ 

OffsetClipRgn 

クリッビングリージョンを移動する 

197 

OpenClipboard 

クリップボードをオープンする 

40 

PageSetupDlg 

印刷ページ設定のダイアログを作成する 

45 

PaintRgn 

逸択されているブラシパターンでリージョンを塗りつぶす 

275 

PathToRegion 

パスからリージョンを作成 

273 

Pie 

域形を描_する 

256 

Polygon 

多角形を描 rt する 

257 

PolyTextOut 

段数の文字列を描く 

262 

PrintDlg 

テキストを印 Wij するためのダイアログボックスを作成する 

46 

PropertyShcet 

プロパティシート在示 

75 

PropS hee t Page Proc 

ブロパティシートページ初期化 

76 

PropSheetProc 

プロパティシート初期化 

77 

PtVisible 

指定された点が指定されたリージョン内にあるかどうかを調べる 

198 

RaiseExccption 

例外を起こす 

336 

ReadFile 

ファイルから説み取る 

296 

RealizePalette 

論理パレットのエントリをシステムパレットに剤り当てる 

211 

RectVisible 

方形の一部が指定されたリージョン内にあるかどうかを凋べる 

198 

Redraw Window 

ウィンドウを丨4描_する 

60 

RegCreateKey 

キーを作成またはオープン 

319 

RegDeleteKey 

キーを削除 


RegisterClass 

ウィンドウクラスを®鉍する 

66 

RegisterDialogClasses 

スクリーンセーバーのダイアログボックスのクラスを妤録する 

139 

RegSetValue 

指定されたキーにテキスト文字列を閲迚付ける 

321 

ReleaseCapture 

マウスキャプチャーを終 f する 

57 

RemoveDircctory 

既存のディレクトリを除去 

297 

ReplaceText 

テキストを!換するためのダイアログボックスを作成する 

47 

ResizePalette 

指定された論理パレットのサイズを変史する 

212 

ScaleViewportExtEx 

ビューポートの範 M をスケーリング 

240 

ScaleWindowExtEx 

ウィンドウの範 M をスケーリング 

241 

ScreenSaverConfigureDialog 

設定用ダイアログボックスのメッセージを処理する 

140 

ScreenSaverProc 

スクリーンセーバーのウィンドウメッセージを処理する 

141 

Screen roCIient 

指定されたディスプレイ上の点のスクリーン座標をクライアント座撩に変換 
する 

242 

ScrollDC 

M 方形を水平方向または垂直方向にスクロールする 

118 

Scroll Window 

クライアント谢域の内容を移®/する 

119 

SelectClipPath 

現在のパスをクリップリージョンとして遠択 

199 

SelectClipRgn 

クリッビングリージョンを迸択する 

200 
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API 関数 

概 要 

ページ 

SelectPalette 

淪理パレットをデバイスコンテキストの中に： s 択する 

213 

SendDlgltemMessage 

ダイアログボックス内のコントロールにメッセージを送る 

106 

SendMessage 

1つ以卜.のウィンドウにメッセージを送る 

56 

SctBitmapBits 

ビット rtt ! 列からビットマップビットを設定 

169 

SetBitmapDnnensionEx 

ビットマップの幅と高さを設定 

170 

SetBrushOrgEx 

現在のブラシの原点を設定 

189 

SetCapture 

マウスキャプチャーを開始する 

57 

SetColorAdjustment 

デバイスコンテキストに対する色の, M 幣姑:を設定 

214 

SetDIBColorTable 

ビットマップからカラー蛸設定 

171 

SctDIBits 

ビットマップのビットを,没定する 

172 

SctDIBitsToDcvicc 

デバイスに DIB のビットを股定する 

173 

SetDlgltemlnt 

コントロールのタイトルまたはテキストを幣数 W で衣された文ネ列に•没定する 


SetDlgltemText 

コントロールのタイトルやテキストを設定する 

108 

SetDoubleClickTimc 

マウスのダブルクリック時間を,没定する 

58 

SetGraphicsMtxle 

指定された DC に対するグラフィックスモードを設定 

242 

SetMapMcxle 

指定されたデバイスコンテキストのマッピングモードを股定する 

244 

SetMetaRgn 

クリップリージョンをメタリージョンとして透択 

201 

SetPaletteEntries 

論理パレットに新しいパレットエントリを設定する 

215 

SetPixel 

ピクセルの RGB W を股定する 

175 

SetPixelV 

ピクセルを指定された色に•没定 

176 

SetProp 

プロパティリストを•没定する 

68 

SetRect 

M 方形の座標を設定する 

63 

SetScrolIPos 

スクロールボックスの位趵を設定する 

121 

SetScrollRange 

スクロールバーの、位趵の伋人と W 小«を設定する 

122 

SetStretchBItMode 

伸縮モードを設定する 

177 

SetSystemPalettellse 

アプリケーションがシステムパレット令体にアクセスできるようにする 

216 

SetTextAlign 

テキスト文字列をデバイスやディスプレイに配趵する 

263 

SetTextColor 

テキストの色を設定する 

264 

SetTimer 

システムタイマを生成する 

65 

SetUnhiindledExceptionFilter 

既存のものに代わるフィルタ例外阅数を設定 

337 

SetViewportExtEx 

ビューポートの範 M を設定 

246 

Set W i ndowExtEx 

ウィンドウの範 M を設定 

247 

SetWindowText 

ウィンドウのタイトルやテキストを設定する 

36 

SetWorldTransform 

現在のワールド座技変換を設定 

248 

ShellAbout 

Windows が提供するバージョン W 報のダイアログボックスを在示 

148 

ShellExecute 

指定されたファイルをオーブンまたは表示 

149 

ShowCursor 

マウスカーソル表示カウントを1つ增加または1つ滅少させる 

52 
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付録 B アルファ 5ット順 API — K 


API 関数 

概 要 

ぺージ 

ShowHideMenuCtl 

メニュー項 13 チヱック K 性と表示非表示設定 

71 

ShowScrollBar 

スクロールバーと その コントロールを 衣示したり非衣/ に したりする 

124 

StretchBIt 

コ ピー元から コ ピー先のデバイスにビットマップを拡大.縮小 コ ピーする 

178 

StretchDIBits 

送元から送先の長方形に DIB を送する 

180 

SwitchDesktop 

デスクトップを交換する 

348 

TextOut 

現在のフォントを使用して、文字列を,*〖き込む 

265 

UnhandledExceptionFilter 

アプリケーシヨンへの例外をフィルタする 

338 

UnrealizeObject 

指定されたブラシの原点をリセットするように GDI に指示する 

218 

Unregisteivlass 

ウインドウクラスをウインドウクラステーブルから削除する 

67 

UpdatcColors 

クライァント如域内の色を史新 

219 

UpdateWindow 

ウィンドウを史新する 

62 

VerFindFile 

インストール位趵利定 

128 

VerlnstallFile 

ファイルインストール 


VerLanguageName 

言鋁識別子変換 

134 

VerQueryValue 

バージョンリソース内界取 

136 

VirtualAlloc 

指定範 M の仮想ページを P 約 

304 

WinExec 

ほかのァプリケーションを灾行する 

317 

WinHelp 

Windows ヘルプァプリケーションを起则し、コンテキスト怡報やトピック怡報を 
渡す 

298 

ZeroMemory 

メモリブロックの内界をすべて0にする 



: 了通 APIIW 


371 











































付 録 


付録 C Visual Basic 用構造体定義一覧 


以下は、本害で扱っている API 関数が利用する構造体をアルファべット順に列拏した一 K である 0 
利用方法やコーディングについては「 1.5 Visual Basic からの Windows API 呼び出し J を#照し 
てもらいたい 。 Visual C++ では、ヘッダファイルをインクルードすることで定義されるので特に 
利用する必要はない。 


Type ABC 
abcA As Long 
abcB As Long 
abcC As Long 
End Type 

Type ABCFLOAT 
abcfA As Double 
abcfB As Double 
abcfC As Double 
End Type 

Type ACCEL 
fVirt As Byte 
key As Integer 
cmd As Integer 
End Type 

Type ACCESS 一 ALLOWED_ACE 

Header As ACE_HEADER 
Mask As Long 
SidStart As Long 
End Type 

Type ACCESS_DENIED 一 ACE 

Header As ACE_HEADER 
Mask As Long 
SidStart As Long 
End Type 


Type ACE_HEADER 

AceType As Byte 
AceFlags As Byte 
AceSize As Long 
End Type 


Type ACL 

AclRevision As Byte 
Sbzl As Byte 
AcISize As Integer 
AceCount As Integer 
Sbz2 As Integer 
End Type 


Type ACL 一 REVISIONJNFORMATION 

AclRevision As Long 
End Type 


Type ACL—SIZE—INFORMATION 

AceCount As Long 
AcIBytesInUse As Long 
AclBytesFree As Long 
End Type 

Type ACTION_HEADER 

transported As Long 
action_code As Integer 
Reserved As Integer 
End Type 


Type ADAPTER.STATUS 

adapter 一 address As String*6 
rev_major As Integer 
reservedO As Integer 
adapter 一 type As Integer 
rev_minor As Integer 
duration As Integer 
frmr 一 reev As Integer 
frnir 一 xmit As Integer 
iframe 一 reev—err As Integer 
xmi し aborts As Integer 
xmi し success As Long 
recv_success As Long 
iframe_xmit_err As Integer 
recv_buff_unavail As Integer 
tl jimeouts As Integer 
tLtimeouts As Integer 
Reserved I As Long 
free_ncbs As Integer 
max_cfg_ncbs As Integer 
max_ncbs As Integer 
xmi し buflunavail As Integer 
max 一 dgram—size As Integer 
pending_sess As Integer 
max 一 cfg—sess As Integer 
max 一 sess As Integer 
max_sess 一 pk し size As Integer 
name 一 count As Integer 
End Type 


Type ADDJOBJNFO 」 

Path As String 
Jobld As Long 
End Type 


Type ANIMATIONINFO 

cbSize As Long 
iMinAnimate As Long 
End Type 


Type APPBARDATA 

cbSize As Long 
hwnd As Long 
uCallbackMessagc As Long 
uEdge As Long 
rc As Reel 
IParam As Long 
End Type 

Type AUXCAPS 
wMid As Integer 
wPid As Integer 
vDrivcrVcrsion As Long 
szPnamc As 

String*MAXPNAMELEN 
wTechnology As Integer 
dwSupport As Long 
End Type 


Type BITMAP 
bmTypc As Long 
bmWidth As Long 
bmHeight As Long 
bmWidthBytes As Long 
bmPlanes As Integer 
bmBitsPixel As Integer 
bmBits As Long 
End Type 


Type BITMAPCOREHEADER 

bcSize As Long 
bcWidth As Integer 
bcHeight As Integer 
bcPlanes As Integer 
bcBitCount As Integer 
End Type 


Type BITMAPCOREINFO 

bmciHeader 

As BITMAPCORE HEADER 
bmciColors As RGBTRIPLE 
End Type 
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付録 C Visual Basic 用構造体定義一!！ 


Type BITMAPFILEHEADER 

btTypc As Integer 
bfSize As Long 
bfReservcdl As Integer 
bt^Reserved2 As Integer 
bfOffBits As Long 
End Type 


Type BITMAPINFO 

bmiHeader 

As BITMAPINFOHEADER 
bmiColors As RGBQUAD 
End Type 

Type BITMAPINFOHEADER 

biSize As Long 
biWidth As Long 
biHeight As Long 
biPlanes As Integer 
biBitCount As Integer 
biCompression As Long 
biSizelmage As Long 
biXPelsPerMeter As Long 
biYPelsPerMctcr As Long 
biCIrllsed As Long 
biClrlmportant As Long 
End Type 


Type BITMAPV4HEADER 

bV4Size As Long 
bV4Width As Long 
bV4Height As Long 
bV4Planes As Integer 
bV4BitCount As Integer 
bV4V4Compression As Long 
bV4SizeImage As Long 
bV4XPcIsPerMeter As Long 
bV4YPelsPerMcter As Long 
bV4ClrUsed As Long 
bV4ClrImportant As Long 
bV4RcdMask As Long 
bV4GreenMask As Long 
bV4BlueMask As Long 
bV4AlphaMask As Long 
bV4CSType As Long 
bV4Endpoints As Long 
bV4GammaRed As Long 
bV4GammaGreen As Long 
bV4GanimaBlue As Long 
End Type 


Type BY 一 HANDLE_FILE_ 

INFORMATION 

dwFilcAttributes As Long 
ftCreationTime As FILETIME 
ftLastAccessTime As FILETIME 
ftLaslWriteTime As FILETIME 
dwVolumeSerialNumber As Long 
nFilcSizeHigh As Long 
nFileSizeLow As Long 
nNumberOfLinks As Long 
nFilelndexHigh As Long 
nFilelndcxLow As Long 
End Type 

Type CANDIDATEFORM 

dwlndcx As Long 
dwStyle As Long 
ptCurrcntPos As POINTAPI 
rcArca As Rect 
End Type 

Type CANDIDATELIST 

dwSize As Long 
dwStyle As Long 
dwCount As Long 
dwSclection As Long 
dwPagcStart As Long 
dwPageSize As Long 
dwOffseK 1)As Long 
End Type 


Type CBT_CREATEWND 

Ipcs As CREATESTRUCT 
hWndlnsertAfter As Long 
End Type 

Type CBTACTIVATESTRUCT 

fMouse As Boolean 
hWndActive As Long 
End Type 


Type CHARJNFO 
Char As Integer 
Attributes As Integer 
End Type 


Type CHARSETINFO 

ciCharsct As Long 
ciACP As Long 
fs As FONTSIGNATURE 
End Type 


Type CHOOSECOLOR 

IStructSize As Long 
hwndOwner As Long 
hInstance As Long 
rgbResult As Long 
IpCustColors As Long 
flags As Long 
ICustData As Long 
IpfnHook As Long 
lpTemplateName As String 
End Type 


Type CHOOSEFONT 

IStruclSize As Long 
hwndOwner As Long 
hdc As Long 

lpLogFont As LOG FONT 
iPointSize As Long 
flags As Long 
rgbColors As Long 
ICustData As Long 
IpfnHook As Long 
lpTemplateName As String 
hInstance As Long 
Ips/Style As String 
nFontTypc As Integer 
MISSING^ALIGNMENT As Integer 
nSizeMin As Long 
nSizeMax As Long 
End Type 


Type CIEXYZ 
ciexyzX As Long 
cicxyzY As Long 
ciexyzZ As Long 
End Type 


Type CIEXYZTRIPLE 

ciexyzRed As CIEXYZ 
ciexyzGreen As CIEXYZ 
cicxyBluc As CIEXYZ 
End Type 

Type CLIENTCREATESTRUCT 

hWindowMenu As Long 
idFirstChild As Long 
End Type 

Type COLORADJUSTMENT 

caSize As Integer 
caFlags As Integer 
callluminantlndcx As Integer 
caRedGamma As Integer 


付 録 


caGreenuamma As Integer 
caBIueGamma As Integer 
caRefercnceBlack As Integer 
caReferenccWhite As Integer 
caContrast As Integer 
caBrightncss As Integer 
caColorfulness As Integer 
caRedGreenTint As Integer 
End Type 


Type COMMCONFIG 

dwSize As Long 
wVcrsion As Integer 
wReserved As Integer 
debx As DCB 

dwProvidcrSubTypc As Long 
dwProviderOffset As Long 
dwProviderSize As Long 
wcProviderData As Byte 
End Type 


Type COMMPROP 

wPackctLength As Integer 
wPackctVersion As Integer 
dwServiccMask As Long 
dwReservcdl As Long 
dwMaxTxQueue As Long 
dwMaxRxQueue As Long 
dwMaxBaud As Long 
dwProvSubTypc As Long 
dwProvCapabilities As Long 
dwSettablcParams As Long 
dwSettablcBaud As Long 
wSettableData As Integer 
wSettableStopParity As Integer 
dwCurrcntTxQueue As Long 
dwCurrentRxQueue As Long 
dwProvSpecl As Long 
dwProvSpcc2 As Long 
wcProvChar(1)As Integer 
End Type 


Type COMMTIMEOUTS 

ReadIntervalTimeout As Long 
ReadTotalTimcoutMulliplicr As Long 
ReadTotalTimcoutConstant As Long 
WritcTotalTimcoutMultiplicr As Long 
WriteTotalTinicoutConstant As Long 
End Type 


Type COMPAREITEMSTRUCT 

CtlTypc As Long 
CtllD As Long 
hwndltem As Long 
itemIDl As Long 


itcmDatal As Long 
itemID2 As Long 
itemData2 As Long 
End Type 

Type COMPOSITIONFORM 

dwStyle As Long 
ptCurrentPos As POINT API 
rcArea As Reel 
End Type 


Type COMSTAT 
fCtsHold As Long 
tDsrHoId As Long 
tKlsdHold As Long 
fXoffHold As Long 
fXofTSent As Long 
fEof As Long 
fTxim As Long 
^Reserved As Long 
cblnQue As Long 
cbOutQue As Long 
End Type 

Type CONSOLE_CURSOR JNFO 

dwSize As Long 
bVisible As Boolean 
End Type 

Type CONSOLE_SCREEN_ 

BUFFER JNFO 

dwSize As COORD 
dwCursorPosition As COORD 
wAttributes As Integer 
srWindow As SMALL_RECT 
dwMaximumWindowSize As COORD 
End Type 

Type CONTEXT 
FltFO As Double 
RtFl As Double 
RtF2 As Double 
FltF3 As Double 
FltF4 As Double 
FltF5 As Double 
FltF6 As Double 
FltF7 As Double 
FltF8 As Double 
FltF9 As Double 
FltFlO As Double 
FllFI 1 As Double 
FltF12 As Double 
FltF13 As Double 


FltFI4 As Double 
FUF15 As Double 
FUF16 As Double 
FltF17 As Double 
FltF18 As Double 
FUFI9 As Double 
FUF20 As Double 
FUF21 As Double 
FUF22 As Double 
FltF23 As Double 
FUF24 As Double 
FltF25 As Double 
FltF26 As Double 
FUF27 As Double 
FltF28 As Double 
FHF29 As Double 
FltF30 As Double 
FUF31 As Double 
IntVO As Double 
IntTO As Double 
IntTl As Double 
IntT2 As Double 
IniT3 As Double 
IntT4 As Double 
IntT5 As Double 
IntT6 As Double 
IntT7 As Double 
IntSO As Double 
IntSl As Double 
IntS2 As Double 
IntS3 As Double 
IntS4 As Double 
IntS5 As Double 
IntFp As Double 
IntAO As Double 
IntAI As Double 
IntA2 As Double 
IntA3 As Double 
IntA4 As Double 
IntA5 As Double 
IntT8 As Double 
IntT9 As Double 
IntTIO As Double 
IntTl1 As Double 
IntRa As Double 
IntTl2 As Double 
IntAt As Double 
IntGp As Double 
IntSp As Double 
IntZero As Double 
Fpcr As Double 
SoftFpcr As Double 
Fir As Double 
Psr As Long 
ContextFlags As Long 
Fill(4) As Long 
End Type 
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Type CONVCONTEXT 

cb as Long 

wFlags As Long 

wCountrylD As Long 

iCodePage As Long 

dwLangID As Long 

dwSecurity As Long 

qos As SECURrTYJJUAUTY ， 

OF.SERVICE 

End Type 


Type CONVINFO 
cb As Long 
hUscr As Long 
hConvPartncr As Long 
hszSvcPartner As Long 
hszServiceReq As Long 
hszTopic As Long 
hszltcm As Long 
wFmt As Long 
wTypc As Long 
wStatus As Long 
wConvst As Long 
wLastError As Long 
hConvList As Long 
ConvCtxt As CONVCONTEXT 
hwnd As Long 
hwndPartncr As Long 
End Type 


Type COORD 
x As Integer 
y As Integer 
End Type 


Type COPYDATASTRUCT 

dwData As Long 
cbData As Long 
IpData As Long 
End Type 

Type CPINFO 

MaxCharSize As Long 
DefaultChar(MAX_DEFAUL 

TCHAR) As Byte 
LeadByte(MAX_LEADBYTES) 

As Byte 

End Type 


Type CREATE 一 PROCESS 

DEB( 


INFO 


hFile As Long 
hProcess As Long 


hThread As Long 
lpBaseOflmage As Long 
dwDcbuglnfoFileOffset As Long 
nDebuglnfoSize As Long 
lpThreadLocalBase As Long 
IpStartAddress As Long 
IpIniageName As Long 
fUnicode As Integer 
End Type 


Type 

CREATE 一 THREAD 一 DEBUG JNFO 

hThread As Long 
lpThreadLocalBase As Long 
IpStartAddress As Long 
End Type 


Type CREATESTRUCT 

IpCreateParams As Long 
hInstance As Long 
hMcnu As Long 
hWndParcnt As Long 
cy As Long 
cx As Long 
y As Long 
x As Long 
style As Long 
IpszName As String 
IpszClass As String 
ExStyle As Long 
End Type 


Type CRGB 
bRcd As Byte 
bGrccn As Byte 
bBlue As Byte 
bExtra As Byte 
End Type 


Type CRITICAL 一 SECTION 

dummy As Long 
End Type 


Type CURRENCYFMT 

NumDigits As Long 
LcadingZero As Long 
Grouping As Long 
lpDecimalSep As String 
IpThousandSep As String 
NegativeOrder As Long 
PositiveOrder As Long 
lpCurrencySymbol As String 
End Type 


Type CWPSTRUCT 
IParam As Long 
wParam As Long 
message As Long 
hwnd As Long 
End Type 


Type DATATYPESJNFOJ 

pName As String 

End Type 

Type DCB 

DCBlength As Long 
BaudRate As Long 
tBinary As Long 
(Parity As Long 
fOutxCtsFlow As Long 
fOutxDsrFlow As Long 
fDtrControl As Long 
fDsrSensitivity As Long 
lTXContinueOnXoff As Long 
fOutX As Long 
flnX As Long 
fErrorChar As Long 
fNull As Long 
fRtsControl As Long 
fAbortOnError As Long 
fDummy2 As Long 
wReserved As Integer 
Xonum As Integer 
XoffLim As Integer 
ByteSize As Byte 
Parity As Byte 
StopBits As Byte 
XonChar As Byte 
XoffChar As Byte 
ErrorChar As Byte 
EofChar As Byte 
EvtChar As Byte 

End Type 


Type DDEACK 

bAppReturnCcxle As Integer 
Reserved As Integer 
fbusy As Integer 
fack As Integer 
End Type 


Type DDEADVISE 
Reserved As Integer 
fDeferUpd As Integer 
fAckReq As Integer 
cfFomiat As Integer 
End Type 
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Type DDEDATA 
unused As Integer 
fresponse As Integer 
t'Release As Integer 
Reserved As Integer 
fAckRcq As Integer 
cfPormat As Integer 
Value(l) As Byte 
End Type 


Type DDELN 
unused As Integer 
fRelease As Integer 
fDeferUpd As Integer 
fAckRcq As Integer 
cfFormat As Integer 
End Type 

Type DDEML MSG_HOOK_DATA 

uiLo As Long 
uiHi As Long 
cbData As Long 
Data(8) As Long 
End Type 

Type DDEPOKE 
unused As Integer 
fRelease As Integer 
fReserved As Integer 
cfFormat As Integer 
Value ⑴ As Byte 
End Type 


Type DDEUP 
unused As Integer 
fAck As Integer 
fRelease As Integer 
t'Reservcd As Integer 
fAckRcq As Integer 
cfFormat As Integer 
rgb(1)As Byte 
End Type 

Type DEBUGHOOKINFO 

hModulcHcwk As Long 
Reserved As Long 
IParam As Long 
wParam As Long 
code As Long 
End Type 

Type DELETEITEMSTRUCT 

CtlType As Long 


CtUD As Long 
itcmID As Long 
hwndltem As Long 
itemData As Long 
End Type 


Type DEVMODE 
dmDeviceName As 

String*CCHDEVICENAME 
dmSpccVcrsion As Integer 
dmDrivcrVersion As Integer 
dmSize As Integer 
dmDrivcrExtra As Integer 
dmhtelds As Long 
dmOricntation As Integer 
dmPaperSize As Integer 
dmPaperLength As Integer 
dmPapcrWidth As Integer 
dmScalc As Integer 
dmCopies As Integer 
dmDelauItSource As Integer 
dmPrintQuality As Integer 
dmColor As Integer 
dmDuplex As Integer 
dmYResolution As Integer 
dmTTOption As Integer 
dniCollatc As Integer 
dmFormName 

As String*CCHFORMNAME 
dmUnuscdPadding As Integer 
dmBitsPerPel As Integer 
dmPelsWidth As Long 
dmPelsHeight As Long 
dmDisplayFlags As Long 
dmDisplayFrequency As Long 
End Type 

Type DEVNAMES 

wDriverOffset As Integer 
wDcviceOffset As Integer 
wOutputOffset As Integer 
wDcfault As Integer 
End Type 

Type DLGITEMTEMPLATE 

style As Long 
dwExtendedStyle As Long 
x As Integer 
y As Integer 
cx As Integer 
cy As Integer 
id As Integer 
End Type 


Type DLGTEMPLATE 

style As Long 
dwExtendedStyle As Long 
edit As Integer 
x As Integer 
y As Integer 
cx As Integer 
cy As Integer 
End Type 


Type DOCJNFO 一 1 
pDocName As String 
pOutputFile As String 
pDatatype As String 
End Type 

Type DOCJNFO 一 2 
pDocName As String 
pOutputFile As String 
pDatatype As String 
dwMode As Long 
Jobld As Long 
End Type 


Type DOCINFO 
cbSize As Long 
IpszDocName As String 
Ips/Output As String 
End Type 


Type DRAGINFO 
uSize As Long 
pt As POINTAPI 
fNC As Boolean 
IpFilcList As String 
grfKeyState As Long 
End Type 

Type DRAWITEMSTRUCT 

CtlType As Long 
CtllD As Long 
itcmID As Long 
itemAction As Long 
itemState As Long 
hwndltem As Long 
hdc As Long 
rcitem As Rect 
itemData As Long 
End Type 

Type DRAWTEXTPARAMS 

cbSize As Long 
iTabLength As Long 
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iLeftMargin As Long 
iRightMargin As Long 
uiLcngthDrawn As Long 
End Type 


Type DRIVERJNFO 」 

pName As String 
End Type 


Type DRIVERJNF0.2 

cVersion As Long 
pName As String 
pEnvironmcnt As String 
pDriverPath As String 
pDataFilc As String 
pConfigFile As String 
End Type 


Type DRIVERJNF0_3 

cVersion As Long 
pName As Siring 
pEnvironment As String 
pDriverPath As String 
pDataFilc As String 
pConfigFile As String 
pHelpFile As String 
pDcpcndcntFilcs As String 
pMonitorNamc As String 
pDefaultDataTypc As String 
End Type 


Type DRVCONFIGINFO 

dwDCISize As Long 
IpszDCISectionName As String 
IpszDCIAIiasNamc As String 
dnDcvNode As Long 
End Type 


Type emr 

iTypc As Long 
nSize As Long 
End Type 


Type EMRABORTPATH 

pEmr As emr 
End Type 


Type EMRANGLEARC 

pEmr As emr 
ptICenter As POINTL 
nRadius As Long 
eStartAngle As Double 
eSweepAngle As Double 
End Type 


Type EMRARC 
pEmr As emr 
rcIBox As RECTL 
ptIStart As POINTL 
ptlEnd As POINTL 
End Type 

Type EMRARCTO 
pEmr As emr 
rcIBox As RECTL 
ptIStart As POINTL 
ptlEnd As POINTL 
End Type 


Type EMRBEGINPATH 

pEmr As emr 
End Type 


Type EMRBITBLT 
pEmr As emr 
rclBounds As RECTL 
xDest As Long 
yDest As Long 
cxDest As Long 
cyDest As Long 
dwRop As Long 
xSrc As Long 
ySrc As Long 
xformSrc As xform 
crBkCoIorSrc As Long 
iUsageSrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
offBitsSrc As Long 
cbBitsSrc As Long 
End Type 


Type EMRCHORD 
pEmr As emr 
rcIBox As RECTL 
ptIStart As POINTL 
ptlEnd As POINT し 
End Type 


Type EMRCLOSEFIGURE 

pEmr As emr 
End Type 


Type EMRCREATEBRUSHIN 

DIRECT 

pEmr As emr 
ihBrush As Long 
lb As LOGBRUSH 
End Type 


Type EMRCREATECOLORSPACE 

pEmr As emr 
ihCS As Long 
les As LOGCOLORSPACE 
End Type 


Type EMRCREATED 旧 

PATTERNBRUSHPT 

pEmr As emr 
ihBursh As Long 
iUsage As Long 
offBmi As Long 
cbBmi As Long 
offBils As Long 
chBits As Long 
End Type 


Type EMRCREATEMONOBRUSH 

pEmr As emr 
ihBrush As Long 
iUsage As Long 
offBmi As Long 
cbBmi As Long 
ofTBits As Long 
cbBits As Long 
End Type 


Type EMRCREATEPALETTE 

pEmr As emr 
ihPal As Long 
Igpl As LOGPALETTE 
End Type 


Type EMRCREATEPEN 

pEmr As emr 
ihPen As Long 
lopn As LOG PEN 
End Type 


Type EMRDELETEOBJECT 

pEmr As emr 
ihObjcct As Long 
End Type 


Type EMRELLIPSE 

pEmr As emr 
rcIBox As RECTL 
End Type 

Type EMREMRSAVEDC 

pEmr As emr 
End Type 
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Type EMRENDPATH 

pEmr as emr 
End Type 

Type EMREOF 
pEmr As emr 
nPalEntries As Long 
offPalEntries As Long 
nSize し ast As Long 
End Type 


Type EMREXCLUDECLIPRECT 

pEmr As emr 
rclCIip As RECTL 
End Type 


TypeEMREXTCREATE 

FONTINDIRECT 

pEmr As emr 
ihFont As Long 
elfw As EXTLOGFONT 
End Type 


Type EMREXTCREATEPEN 

pEmr As emr 
ihPen As Long 
offBnii As Long 
cbBmi As Long 
offBits As Long 
cbBits As Long 
elp As EXTLOGPEN 
End Type 


Type EMREXTFLOODFILL 

pEmr As emr 
ptIStart As POINTL 
crColor As Long 
i Mode As Long 
End Type 


Type EMREXTSELECTCLIPRGN 

pEmr As emr 
cbRgnData As Long 
iMode As Long 
RgnData(1)As Integer 
End Type 


Type EMREXTTEXTOUT 

pEmr As emr 
rclBounds As RECTL 
iGraphicsModc As Long 
exScale As Double 
eyScale As Double 
emrtext As emrtext 
End Type 


Type EMRFILLPATH 

pEmr As emr 
rcl Bounds As RECTL 
End Type 


Type EMRFILLRGN 

pEmr As emr 
rcl Bounds As RECTL 
cbRgnData As Long 
ihBrush As Long 
RgnData(l) As Integer 
End Type 


Type EMRFLATTENPATH 

pEmr As emr 
End Type 


Type EMRFRAMERGN 

pEmr As emr 
rcl Bounds As RECTL 
cbRgnData As Long 
ihBrush As Long 
szIStroke As SIZEL 
RgnData(l) As Integer 
End Type 


Type EMRGDICOMMENT 

pEmr As emr 
cbData As Long 
Data(l) As Integer 
End Type 


Type EMRINTERSECTCLIPRECT 

pEmr As emr 
rclCIip As RECTL 
End Type 


Type EMRINVERTRGN 

pEmr As emr 
rcl Bounds As RECTL 
cbRgnData As Long 
RgnData(l) As Integer 
End Type 


Type EMRLINETO 
pEmr As emr 
ptl As POINTL 
End Type 


Type EMRMASKBLT 

pEmr As emr 

rcl Bounds As RECTL 

xDest As Long 


yDcst As Long 
cxDest As Long 
cyDest As Long 
dwRop As Long 
xSrc2 As Long 
cyDest2 As Long 
dwRop2 As Long 
xSrc As Long 
ySrc As Long 
xformSrc As XFORM 
crBkColorSrc As Long 
iUsagcSrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
otTBitsSrc As Long 
cbBilsSrc As Long 
xMask As Long 
yMask As Long 
illsagcMask As Long 
offBmiMask As Long 
cbBmiMask As Long 
offBitsMask As Long 
cbBitsMask As Long 
End Type 


Type EMRMODIFYWORLDTRANSFORM 

pEmr As emr 
xform As XFORM 
iMode As Long 
End Type 


Type EMRMOVETOEX 

pEmr As emr 
ptl As POINTL 
End Type 


Type EMROFFSETCLIPRGN 

pEmr As emr 
ptIOffset As POINTL 
End Type 


Type EMRPAINTRGN 

pEmr As emr 
rcl Bounds As RECTL 
cbRgnData As Long 
RgnData(1)As Integer 
End Type 


Type EMRPIE 
pEmr As emr 
rcl Box As RECTL 
ptIStart As POINTL 
ptIEnd As POINTL 
End Type 
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Type EMRPLGBLT 
pEmr As emr 
rcl Bounds As RECTL 
aptlDest(3) As POINTL 
xSrc As Long 
ySrc As Long 
cxSrc As Long 
cySrc As Long 
xformSrc As XFORM 
crBkColorSrc As Long 
iUsageSrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
offBitsSrc As Long 
cbBitsSrc As Long 
xMask As Long 
yMask As Long 
iUsageMask As Long 
offBmiMask As Long 
cbBmiMask As Long 
offBitsMask As Long 
cbBitsMask As Long 
End Type 


Type EMRPLOYBEZIERTOI6 

pEmr As emr 
rcl Bounds As RECTL 
cpts As Long 
apts(1)As POINTS 
End Type 


Type EMRPOLYBEZIER 

pEmr As emr 
rclBounds As RECTL 
cptl As Long 
aptl(l) As POINTL 
End Type 


Type EMRPOLYBEZIER16 

pEmr As emr 
rclBounds As RECTL 
cpts As Long 
apts(1)As POINTS 
End Type 


Type EMRPOLYBEZIERTO 

pEmr As emr 
rclBounds As RECTL 
cptl As Long 
aptl(l) As POINTL 
End Type 


Type EMRPOLYDRAW 

pEmr As emr 
rclBounds As RECTL 
cptl As Long 
aptl(l) As POINTL 
ab rypes(l) As Integer 
End Type 


Type EMRPOLYDRAW16 

pEmr As emr 
rclBounds As RECTL 
cpts As Long 
apts(1)As POINTS 
ab rypes( I) As Integer 
End Type 


Type EMRPOLYGON 

pEmr As emr 
rclBounds As RECTL 
cptl As Long 
aptl(1)As POINTL 
End Type 


Type EMRPOLYGON16 

pEmr As emr 
rclBounds As RECTL 
cpts As Long 
apts(1)As POINTS 
End Type 


Type EMRPOLYLINE 

pEmr As emr 
rclBounds As RECTL 
cptl As Long 
aptl(l) As POINTL 
End Type 


Type EMRPOLYLINE16 

pEmr As emr 
rclBounds As RECTL 
cpts As Long 
apts(1)As POINTS 
End Type 


Type EMRP0LYLINET016 

pEmr As emr 
rclBounds As RECTL 
cpts As Long 
apts ⑴ As POINTS 
End Type 


Type EMRPOLYPOLYGON 

pEmr As emr 
rclBounds As RECTL 


nPolys As Long 
cptl As Long 
aPolyCounts( I) As Long 
aptl(1)As POINTL 
End Type 


Type EMRPOLYPOLYGON16 

pEmr As emr 
rclBounds As RECTL 
nPolys As Long 
cpts As Long 
aPolyCounts(1)As Long 
apts(1)As POINTS 
End Type 


Type EMRPOLYPOLYLINE 

pEmr As emr 
rclBounds As RECTL 
nPolys As Long 
cptl As Long 
aPolyCounts(1)As Long 
aptl(l) As POINTL 
End Type 


Type EMRPOLYPOLYLINE16 

pEmr As emr 
rclBounds As RECTL 
nPolys As Long 
cpts As Long 
aPolyCounts(1)As Long 
apts ⑴ As POINTS 
End Type 


Type EMRREALIZEPALETTE 

pEmr As emr 
End Type 


Type EMRRECTANGLE 

pEmr As emr 
rcl Box As RECTL 
End Type 


Type EMRRESIZEPALETTE 

pEmr As emr 
ihPal As Long 
cEntries As Long 
End Type 


Type EMRRESTOREDC 

pEmr As emr 
iRelative As Long 
End Type 


Visual 


iss—w - 
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Type EMRROUNDRECT 

phmr As cmr 
rcIBox As RECTL 
szlComcr As SIZEL 
End Type 


Type 

EMRSCALEVIEWPORTEXTEX 

pEmr As emr 
xNum As Long 
xDcnom As Long 
yNum As Long 
yDemon As Long 
End Type 


Type EMRSCALEWINDOWEXTEX 

pEmr As cmr 
xNum As Long 
xDenom As Long 
yNum As Long 
yDemon As Long 
End Type 


Type EMRSELECTCLIPPATH 

pEmr As emr 
i Mode As Long 
End Type 


Type EMRSELECTCOLORSPACE 

pEmr As emr 
ihCS As Long 
End Type 


Type EMRSELECTOBJECT 

pEmr As cmr 
ihObject As Long 
End Type 


Type EMRSELECTPALETTE 

pEmr As emr 
ihPal As Long 
End Type 


Type EMRSETARCDIRECTION 

pEmr As cmr 
iArcDirection As Long 
End Type 


Type EMRSETBKCOLOR 

pEmr As emr 
crColor As Long 
End Type 


Type EMRSETBKMODE 

pEmr As emr 
i Mode As Long 
End Type 


Type EMRSETBRUSHORGEX 

pEmr As cmr 
ptlOrigin As POINTL 
End Type 


Type 

EMRSETCOLORADJUSTMENT 

pEmr As cmr 
ColorAdjustment As 
Color Adjustment 
End Type 


Type EMRSETD 旧 ITSTODEVICE 

pEmr As emr 
rcl Bounds As RECTL 
xDcst As Long 
yDest As Long 
xSrc As Long 
ySrc As Long 
cxSrc As Long 
cySrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
of fBitsSrc As Long 
cbBitsSrc As Long 
iUsagcSrc As Long 
iSlartScan As Long 
cScans As Long 
End Type 


Type EMRSETMAPMODE 

pEmr As emr 
iMode As Long 
End Type 


Type EMRSETMAPPERFLAGS 

pEmr As emr 
dwFIags As Long 
End Type 


Type EMRSETMETARGN 

pEmr As emr 
End Type 


Type EMRSETMITERLIMIT 

pEmr As emr 
eMiterLimit As Double 
End Type 


Type EMRSETPALETTEENTRIES 

pEmr As emr 
ihPal As Long 
iStart As Long 
cEntries As Long 

aPalEntries ⑴ As PALETTEENTRY 
End Type 


Type EMRSETPIXELV 

pEmr As emr 
ptlPixcl As POINTL 
crColor As Long 
End Type 


Type EMRSETPOLYFILLMODE 

pEmr As emr 
iMode As Long 
End Type 


Type EMRSETROP2 

pEmr As emr 
i Mode As Long 
End Type 

Type EMRSETSTRETCHBLTMODE 

pEmr As emr 
i Mode As Long 
Ena fype 


Type EMRSETTEXTALIGN 

pEmr As emr 
iMode As Long 
End Type 


Type EMRSETTEXTCOLOR 

pEmr As emr 
crColor As Long 
End Type 


Type EMRSETVIEWPORTEXTEX 

pEmr As emr 
szIExtent As SIZEL 
End Type 


Type EMRSETVIEWPORTORGEX 

pEmr As emr 
ptlOrigin As POINTL 
End Type 

Type EMRSETWINDOWEXTEX 

pEmr As emr 
szIExtent As SIZEL 
End Type 
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Type EMRSETWINDOWORGEX 

pEmr as emr 
ptlOrigin As POINTL 
End Type 


Type EMRSETWORLDTRANSFORM 

pEmr As emr 
xform As XFORM 
End Type 


Type EMRSTRETCHBLT 

pEmr As emr 
rclBounds As RECTL 
xDest As Long 
yDest As Long 
cxDest As Long 
cyDcst As Long 
dwRop As Long 
xSrc As Long 
ySrc As Long 
xformSrc As xform 
crBkCoIorSrc As Long 
illsageSrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
of’fBitsSrc As Long 
cbBitsSrc As Long 
cxSrc As Long 
cySrc As Long 

End Type 

Type EMRSTRETCHD 旧 ITS 

pEmr As emr 
rcIBounds As RECTL 
xDest As Long 
yDest As Long 
xSrc As Long 
ySrc As Long 
cxSrc As Long 
cySrc As Long 
offBmiSrc As Long 
cbBmiSrc As Long 
offBitsSrc As Long 
cbBitsSrc As Long 
iUsageSrc As Long 
dwRop As Long 
cxDest As Long 
cyDcst As Long 

End Type 


Type EMRSTROKEANDFILLPATH 

pEmr As emr 
rcIBounds As RECTL 
End Type 


Type EMRSTROKEPATH 

pEmr As emr 
rcIBounds As RECTL 
End Type 


Type emrtext 

pllReference As POINTL 
nchars As Long 
offString As Long 
fOptions As Long 
rcl As RECTL 
offDx As Long 
End Type 


Type EMRWIDENPATH 

pEmr As emr 
End Type 

Type ENHMETAHEADER 

iTypc As Long 
nSize As Long 
rcIBounds As RECTL 
rcl Frame As RECTL 
dSignature As Long 
nVersion As Long 
nBytes As Long 
nRecords As Long 
nHandles As Integer 
sRcscrvcd As Integer 
nDescription As Long 
offDcscription As Long 
nPalEnlrics As Long 
szIDevice As SIZEL 
szIMillimctcrs As SIZEL 
End Type 


Type ENHMETARECORD 

iType As Long 
nSize As Long 
dParm(1)As Long 
End Type 


Type ENUM.SERVICE_STATUS 

IpServiceName As String 
IpDisplayName As String 
ServiceStatus As 

SERVICE.STATUS 

End Type 


Type ENUMLOGFONT 

clfLogFont As LOGFONT 
cIfFullName(LF_FULLFACE 

SIZE) As Byte 

elfStyle(LF_FACESIZE) As Byte 
End Type 


Type ENUMLOGFONTEX 

elfLogFont As LOGFONT 
elfFullName(LF_FULLFACE 

SIZE) As Byte 

elfStyle(LF.FACESIZE) As Byte 
elfScript(LF_FACESIZE) As Byte 
End Type 

Type EVENTLOGRECORD 

LengthasLong 
RescrvcdasLong 
RecordNumbcrasLong 
TimeGeneratcdasLong 
TimeWrittenasLong 
EventIDasLong 
EvcntTypeasInteger 
NumStringsaslntcgcr 
EventCatcgoryasI nteger 
ReservedFlagsasInteger 
ClosingRecordNumberasLong 
StringOffsctasLong 
UserSidLcngthasLong 
UserSidOffsetasLong 
DataLengthasLong 
DataOffsetasLong 
End Type 

Type EVENTMSG 
message As Long 
paramL As Long 
paramH As Long 
time As Long 
hwnd As Long 
End Type 

Type EXCEPTION.DEBUGJNFO 

pExceptionRecord As 

EXCEPTION.RECORD 
dwFirstChance As Long 
End Type 

Type EXCEPTION_POINTERS 

pExceptionRecord As 

EXCEPTION_RECORD 
Context Record As CONTEXT 
End Type 


Type EXCEPTION_RECORD 

ExceptionCode As Long 
ExceptionFlags As Long 
pExcept ion Record As Long 
Exception Address As Long 
NumberParameters As Long 
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ExceptionInrormation( 

EXCEPTION_MAXIMUM_ 
PARAMETERS) As Long 

End Type 


Type EXrr_PROCESS 一 DEBUGJNFO 

dwExitQxle As Long 
End Type 

Type EXIT—THREAD 一 DEBUGJNFO 

dwExitCode As Long 
End Type 


Type EXTLOGFONT 

clfLogFont As LOGFONT 
cltFullName(LF_FULLFACE 

SIZE) As Byte 

elfStyle(LF_FACESIZE) As Byte 
elfVersion As Long 
clfStyleSize As Long 
clfMatch As Long 
elfReserved As Long 
elfVendorkKELF 一 VENDOR_ 

SIZE) As Byte 

elfCulture As Long 
elfPanose As PANOSE 
End Type 


Type EXTLOGPEN 
clpPcnStyle As Long 
elpWidth As Long 
elpBrushStyle As Long 
elpColor As Long 
elpHatch As Long 
clpNumEntries As Long 
elpStyleEntry(l) As Long 
End Type 


Type FILETIME 

dwLowDateTime As Long 
dwHighDatcTime As Long 
End Type 


Type FIND_NAME_BUFFER 

Length As Integer 
access 一 control As Integer 
frame-control As Integer 
destination_addr(6) As Integer 
source_addr(6) As Integer 
routing_info(18) As Integer 
End Type 


Type FIND_NAME.HEADER 

ncxle^count As Integer 
Reserved As Integer 
unique^group As Integer 
End Type 


Type FINDREPLACE 

IStructSizc As Long 
hwndOwncr As Long 
hlnstance As Long 
flags As Long 
IpstrFindWhat As String 
IpstrReplaceWith As String 
wFindWhatLen As Integer 
wReplaceWithLcn As Integer 
lCustData As Long 
IpfnHook As Long 
IpTcmplateName As String 
End Type 

Type FIXED 
fract As Integer 
Value As Integer 
End Type 

Type FOCUS_EVENT_RECORD 

bSctFocus As Boolean 
End Type 

Type FONTSIGNATURE 

fsUsb(4) As Long 
fsCsb(2) As Long 
End Type 

Type FORM JNFO 一 1 

pName As String 
Size As SIZEL 
ImageableArea As RECT し 
End Type 


Type GCP_RESULTS 

IStructSize As Long 
IpOutString As String 
IpOrder As Long 
IpDX As Long 
lpCaretPos As Long 
lpClass As String 
IpGlyphs As String 
nGlyphs As Long 
nMaxFit As Long 
End Type 


Type GENERIC.MAPPING 

GcnericRead As Long 
Generic Write As Long 
GenericExecute As Long 
GenericAU As Long 
End Type 


Type GLYPHMETRICS 

gmBlackBoxX As Long 
gmBlackBoxY As Long 
gmptGlyphOrigin As POINTAPI 
gmCcllIncX As Integer 
gmCelllncY As Integer 
End Type 


Type HANDLETABLE 

objectHandle(l) As Long 
End Type 


Type HELPINFO 
cbSize As Long 
iContcxtTypc As Long 
iCtrlld As Long 
hhemHandle As Long 
dwContextld As Long 
MousePos As POINTAPI 
End Type 


Type HELPWININFO 

wStructSize As Long 
x As Long 
y As Long 
dx As Long 
dy As Long 
wMax As Long 
rgchMember As String*2 
End Type 


Type HSZPAIR 
hszSvc As Long 
hszTopic As Long 
End Type 


Type ICONINFO 
tlcon As Boolean 
xHotspot As Long 
y Hotspot As Long 
hbmMask As Long 
hbmColor As Long 
End Type 


Type ICONMETRICS 

cbSize As Long 
iHorzSpacing As Long 
iVerlSpacing As Long 
iTitleWrap As Long 
IfFont As LOGFONT 
End Type 


382 














付録 C Visual Basic 用構造体定義一！！ 


Type JOB JNFO 一 1 

Jobld As Long 
pPrinterName As String 
pMachineName As String 
pUserName As String 
pDocument As String 
pDatatypc As String 
pStatus As String 
Status As Long 
Priority As Long 
Position As Long 
Total Pages As Long 
PagcsPrintcd As Long 
Submitted As SYSTEMTIME 
End Type 


Type JOB JNFO 一 2 

Jobld As Long 
pPrinterName As String 
pMachineName As String 
pUserName As String 
pDocument As String 
pNotifyName As String 
pDatatypc As String 
pPrintPrtKessor As String 
pParamctcrs As String 
pDrivcrNamc As String 
pDcvModc As DEVMODE 
pStatus As String 
pSccurityDcscriptor As SECU 

RITY.DESCRIPTOR 
Status As Long 
Priority As Long 
Position As Long 
StartTime As Long 
UntilTime As Long 
Total Pages As Long 
Size As Long 

Submitted As SYSTEMTIME 
time As Long 
PagcsPrintcd As Long 

End Type 

Type JOYCAPS 
wMid As Integer 
wPid As Integer 
s/Pnamc As 

String*MAXPNAMELEN 
wXmin As Integer 
wXmax As Integer 
wYmin As Integer 
wYmax As Integer 
wZmin As Integer 


wZmax As Integer 
wNumButtons As Integer 
wPeriodMin As Integer 
wPeritxIMax As Integer 
End Type 


Type JOYINFO 
wXpos As Integer 
wYpos As Integer 
wZpos As Integer 
wButtons As Integer 
End Type 


Type JOYINFOEX 
dwM/e As Long 
dwhlags As Long 
dwXpos As Long 
dwYpos As Long 
dwZpos As Long 
dwRpos As Long 
dwUpos As Long 
dwVpos As Long 
dwButtons As Long 
dwButtonNumber As Long 
dwPOV As Long 
dwRescrvcdl As Long 
dwReserved2 As Long 
End Type 

Type KERNINGPAIR 

wFirst As Integer 
wSccond As Integer 
i Kern Amount As Long 
End Type 

Type KEY_EVENT_RECORD 

bKcyDown As Boolean 
wRepeatCount As Integer 
wVirtualKeyCode As Integer 
wVirtualScanCode As Integer 
uChar As Integer 
dwControlKeyState As Long 
End Type 


Type LANA^ENUM 
Length As Integer 
lana(MAX_LANA) As Integer 
End Type 


Type LARGEJNTEGER 

lowpart As Long 
highparl As Long 
End Type 


Type LDT—BYTES 
BaseMid As Byte 
Flags 1 As Byte 
Flags2 As Byte 
BaseHi As Byte 
End Type 


Type LDT_ENTRY 
LimitLow As Integer 
BaseLow As Integer 
HighWord As Long 
End Type 

Type LOAD_DLL_DEBUG JNFO 

hFile As Long 
IpBascOtDU As Long 
dwDcbuglnfoFilcOffsct As Long 
nDcbuglnfoSize As Long 
IpImageName As Long 
fUnicode As Integer 
End Type 


Type LOCALESIGNATURE 

lsUsb(4) As Long 
lsCsbDcfault(2) As Long 
lsCsbSupported(2) As Long 
End Type 


Type LOGBRUSH 
IbStyle As Long 
IbColor As Long 
IbHatch As Long 

End Type 

Type LOGCOLORSPACE 

IcsSignaturc As Long 

IcsVersion As Long 

IcsMze As Long 

IcsCSTypc As Long 

lesintent As Long 

IcsEndPoints As CIEXYZTRIPLE 

IcsGammaRed As Long 

IcsGammaGreen As Long 

IcsGammaBlue As Long 

IcsFileName As 

String*MAX_PATH 

End Type 


Type LOGFONT 
IfHeight As Long 
IfWidth As Long 
IfEscapcment As Long 
IfOrientation As Long 
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lfWeight As Long 
lfltalic As Byte 
lfUnderline As Byte 
IfStrikeOut As Byte 
lfCharSet As Byte 
IfOutPrecision As Byte 
lfClipPrecision As Byte 
IfQuality As Byte 
ltPitchAndFamily As Byte 
lfFaceNamc(LF_FACESIZE) 

As Byte 

End Type 


Type LOGPALETTE 

palVersion As Integer 
palNumEntrics As Integer 
palPalEntry(I) 

AsPALETTEENTRY 

End Type 

Type LOGPEN 
lopnStyle As Long 
lopnWidth As POINTAPI 
lopnColor As Long 
End Type 


Type LUID 

LowPart As Long 
HighParl As Long 
End Type 


Type LUID^AND.ATTRIBUTES 

pLuid As LUID 
Attributes As Long 
End Type 


Type MAT2 

eMll As FIXED 
cM12 As FIXED 
eM2l As FIXED 
eM22 As FIXED 
End Type 

Type MCI_ANIM_OPEN_PARMS 

dwCallback As Long 
wDevicelD As Long 
IpstrDcviccTypc As String 
IpstrEIemcntName As String 
IpstrAlias As String 
dwStyle As Long 
hWndParent As Long 
End Type 


Type MCLANIM.PLAY.PARMS 

dwCallback As Long 
dwFrom As Long 
dwTo As Long 
dwSpced As Long 
End Type 

Type MCI_ANIM_RECT_PARMS 

dwCallback As Long 
rc As Rect 
End Type 


Type MCLANIM.STEP.PARMS 

dwCallback As Long 
dwFrames As Long 
End Type 


Type MCLANIM_UPDATE_PARMS 

dwCallback As Long 
rc As Rect 
hdc As Long 
End Type 


Type MCLANIM.WINDOW^PARMS 

dwCallback As Long 
hwnd As Long 
nCmdShow As Long 
IpstrText As String 
End Type 


Type MCI—BREAK_PARMS 

dwCallback As Long 
nVirtKey As Long 
hwndBreak As Long 
End Type 


Type MCLGENERIC.PARMS 

dwCallback As Long 
End Type 


Type MCLGETDEVCAPS_PARMS 

dwCallback As Long 
dwRetum As Long 
dwlten As Long 
End Type 


Type MCIJNFO_PARMS 

dwCallback As Long 
IpstrRcturn As String 
dwRetSize As Long 
End Type 


Type MCI_LOAD_PARMS 

dwCallback As Long 
IpFileNamc As String 
End Type 


Type MCI_OPEN_PARMS 

dwCallback As Long 
wDevicelD As Long 
IpstrDeviceTypc As String 
IpstrElementName As String 
IpstrAlias As String 
End Type 

Type MCI_OVLY_LOAD_PARMS 

dwCallback As Long 
IpFileNamc As String 
rc As Rect 
End Type 

Type MCI_OVLY_OPEN_PARMS 

dwCallback As Long 
wDevicelD As Long 
IpstrDeviceTypc As String 
IpstrEIemcntName As String 
IpstrAlias As String 
dwStyle As Long 
hWndParent As Long 
End Type 

Type MCLOVLY_RECT_PARMS 

dwCallback As Long 
rc As Rect 
End Type 

Type MCLOVLY_SAVE_PARMS 

dwCallback As Long 
lpFileName As String 
rc As Rect 
End Type 


Type MCLOVLY 一 WINDOW—PARMS 

dwCallback As Long 
hwnd As Long 
nCmdShow As Long 
IpstrText As String 
End Type 

Type MCI_PLAY_PARMS 

dwCallback As Long 
dwFrom As Long 
dw To As Long 
End Type 

Type MCLRECORD 一 PARMS 

dwCallback As Long 
dwFrom As Long 
dwTo As Long 
End Type 
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Type MCI_SAVE_PARMS 

dwCallback As Long 
lpFileNamc As String 
End Type 

Type MCI_SEEK_PARMS 

dwCallback As Long 
dwTo As Long 
End Type 

Type MCI_SEQ_SET_PARMS 

dwCallback As Long 
dwTimeFormat As Long 
dwAudio As Long 
dwTcmpo As Long 
dwPort As Long 
dwSlave As Long 
dwMastcr As Long 
dwOffsct As Long 
End Type 

Type MCLSET 一 PARMS 

dwCallback As Long 
dwTimeFormat As Long 
dwAudio As Long 
End Type 

Type MCI_SOUND_PARMS 

dwCallback As Long 
IpstrSoundName As String 
End Type 

Type MCLSTATUS.PARMS 

dwCallback As Long 
dwRcturn As Long 
dwltem As Long 
dwTrack As Integer 
End Type 

Type MCLSYSINFO_PARMS 

dwCallback As Long 
IpstrReturn As String 
dwRctSize As Long 
dwNumbcr As Long 
wDcviccTypc As Long 
End Type 

Type MCLVD_ESCAPE_PARMS 

dwCallback As Long 
IpstrCommand As String 
End Type 

Type MCI_VD 一 PLAY_PARMS 


dwCallback As Long 
dwFrom As Long 
dwTo As Long 
dwSpeed As Long 
End Type 


Type MCLVD 一 STEP_PARMS 

dwCallback As Long 
dwFrames As Long 
End Type 


Type MCLWAVE_DELETE_PARMS 

dwCallback As Long 
dwFrom As Long 
aw To As Long 
End Type 

Type MCI—WAVE_OPEN_PARMS 

dwCallback As Long 
wDevicelD As Long 
IpstrDcviceType As String 
IpstrtlementName As String 
IpstrAlias As String 
dwBufferSeconds As Long 
End Type 

Type MCI_WAVE_SET_PARMS 

dwCallback As Long 
dwTimeFormat As Long 
dwAudio As Long 
wlnput As Long 
wOutput As Long 
wFormatTag As Integer 
wRcserved2 As Integer 
nChannels As Integer 
wRescrved3 As Integer 
nSamplesPerSec As Long 
nAvgBytcsPcrSec As Long 
nBlockAlign As Integer 
wReserved4 As Integer 
wBitsPerSample As Integer 
wRescrved5 As Integer 
End Type 


Type MDICREATESTRUCT 

szClass As String 
s/Title As String 
hOwner As Long 
x As Long 
y As Long 
cx As Long 
cy As Long 
style As Long 
IParam As Long 
End Type 


Type MEASUREITEMSTRUCT 

CtlType As Long 
CtllD As Long 
itemID As Long 
itemWidth As Long 
itemHeight As Long 
itemData As Long 
End Type 

Type MEMORY.BASICJNFORMATION 

BaseAddressasLong 
AllcK % ationBaseasLong 
AllcK'ationPmtect As Long 
RcgionSize As Long 
State As Long 
Protect As Long 
lType As Long 
End Type 

Type MEMORYSTATUS 

dwLength As Long 
dwMcmoryLoad As Long 
dwTotalPhys As Long 
dwAvailPhys As Long 
dwTotalPageFile As Long 
dwAvailPageFilc As Long 
dwTotalVirtual As Long 
dwAvailVirtual As Long 
End Type 

Type MENU_EVENT 一 RECORD 

dwCommandld As Long 
End Type 

Type MENUITEMINFO 

cbSize As Long 
fMask As Long 
fType As Long 
fState As Long 
wID As Long 
hSubMenu As Long 
hbmpChecked As Long 
hbnipUnchcckcd As Long 
dwItemData As Long 
dwTypcData As String 
cch As Long 
End Type 


Type MENUITEMTEMPLATE 

mtOption As Integer 
mtID As Integer 
mtString As Byte 
End Type 
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Type MENUITEMTEMPLATEHEADER 

versionNumber As Integer 
offset As Integer 
End Type 


Type METAFILEPICT 

mm As Long 
xExt As Long 
yExt As Long 
hMF As Long 
End Type 


Type METAHEADER 

mtTypc As Integer 
mtHeaderSize As Integer 
mtVersion As Integer 
mtSize As Long 
mtNoObjects As Integer 
mtMaxRecord As Long 
mtNoParameters As Integer 
End Type 


Type METARECORD 

rdMze As Long 
rdFunction As Integer 
r<JParm(1)As Integer 
End Type 


Type midi 

songptrpos As Long 
End Type 


Type MIDIEVENT 
dwDeltaTimc As Long 
dwStrcamID As Long 
dwEvcnt As Long 
dwParms(1)As Long 
End Type 


Type MIDIHDR 
IpData As String 
dwBufferLength As Long 
dwBytesRecorded As Long 
dwUser As Long 
dwFlags As Long 
IpNext As Long 
Reserved As Long 
End Type 


Type MIDIINCAPS 

wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
s/Pname As 

String*MAXPNAMELEN 

End Type 
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Type MIDIOUTCAPS 

wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
szPnanic As 

String*MAXPNAMELEN 
w Technology As Integer 
wVoices As Integer 
wNotes As Integer 
wChannelMask As Integer 
dwSupport As Long 
End Type 


Type MIDIPROPTEMPO 

cbStruct As Long 
dwTempo As Long 
End Type 


Type MIDIPROPTIMEDIV 

cbStruct As Long 
dwTimcDiv As Long 
End Type 


Type MIDISTRMBUFFVER 

dwVersion As Long 
dwMid As Long 
dwOEMVersion As Long 
End Type 


Type MINIMIZEDMETRICS 

cbSize As Long 
iWidth As Long 
iHor/Gap As Long 
iVertGap As Long 
iArrangc As Long 
ItFont As LOGFONT 
End Type 


Type MINMAXINFO 

ptReserved As POINTAPI 
ptMaxSize As POINTAPI 
ptMaxPosition As POINTAPI 
ptMinTrackSize As POINTAPI 
ptMaxTrackSize As POINTAPI 
End Type 


Type MIXERCAPS 
wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
szPnanic As Slring*MAXPNAMELEN 
fdwSupport As Long 
cDestinations As Long 
End Type 


Type MIXERCONTROL 

cbStruct As Long 
dwControlID As Long 
dwControITypc As Long 
fdwControl As Long 
cMuItipleltems As Long 
szShortName As String*MIXER_ 

SHORT 一 NAME 一 CHARS 
szName As String*MIXER_ 

LONG_NAME_CHARS 
Bounds As Double 
Metrics As Long 
End Type 

Type MIXERCONTROLDETAILS 

cbStruct As Long 
dwControlID As Long 
cChanncIs As Long 
item As Long 
cbDetails As Long 
paDetails As Long 
End Type 


Type MIXERCONTROL 

DETAILS.BOOLEAN 

fValue As Long 
End Type 


Type MIXERCONTROL 

DETAILS 一 USTTEXT 

dwParanil As Long 
dwParam2 As Long 
szName As 

String*MIXER_LONG_NAME_CHA 

RS 

End Type 


Type MIXERCONTROL 

DETAILS_SIGNED 

IValue As Long 
End Type 


Type MIXERCONTROL 

DETA1LS.UNS1GNED 

dwValue As Long 
End Type 


Type MIXERLINE 
cbStruct As Long 
dwDestination As Long 
dwSource As Long 
dwLinelD As Long 
fdwLine As Long 
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dwUser As Long 
dwComponentType As Long 
cChannels As Long 
cConnections As Long 
cControls As Long 
szShortName As String*MIXER 

_SHORT 一 NAME 一 CHARS 
szName As String*MIXER 

_LONG_NAME_CHARS 
lp Target As Target 
End Type 

Type MIXERLINECONTROLS 

cbSlruct As Long 
dwLinelD As Long 
clwControl As Long 
cControls As Long 
cbmxctrl As Long 
pamxctrl As MIXERCONTROL 
End Type 

Type MMCKINFO 
ckid As Long 
ckSize As Long 
fccTypc As Long 
dwDataOffset As Long 
dwFlags As Long 
End Type 


Type MMIOINFO 
dwFlags As Long 
fccIOProc As Long 
plOProc As Long 
wErrorRet As Long 
htask As Long 
cchBuffer As Long 
pchBuffer As String 
pchNext As String 
pchEndRead As String 
pchEndWrile As String 
IBufOffset As Long 
IDiskOffset As Long 
adwInfo(4) As Long 
dwReservedl As Long 
dwRcscrvcd2 As Long 
hmmio As Long 
End Type 

Type MMTIME 
wTypc As Long 
u As Long 
End Type 


Type MODEMDEVCAPS 

dwActualMze As Long 
dwRequiredSize As Long 
dwDevSpccificOffset As Long 
dwDevSpccificSize As Long 
dwMcxlemProviderVersion As Long 
dwModcmManufacturerOtTse 

t As Long 

dwMcxlemManufacturerSize 

As Long 

dwModcmModclOffset As Long 
dwModcmModclSizc As Long 
dwM(xlcmVcrsionOffset As Long 
dwModemVersionSize As Long 
dwDialOptions As Long 
dwCallSetupFailTimer As Long 
dwInactivityTimeout As Long 
dwSpeakerVolume As Long 
dwSpeakerMcxlc As Long 
dwModemOptions As Long 
dwMaxDTERate As Long 
dwMaxDCERate As Long 
abVariablePortion( I) As Byte 
End Type 

Type MODEMSETTINGS 

dwActualSize As Long 
dwRequiredSize As Long 
dwDevSpccificOffset As Long 
dwDevSpecificSize As Long 
dwCallSetupFailTimer As Long 
dwInactivityTimeout As Long 
dwSpeakerVolume As Long 
dwSpcakerMixlc As Long 
dwPrcfcrrcdModemOptions As Long 
dwNegotiatedMcxlemOptions As Long 
dwNegotiatcdDCERate As Long 
abVariablePortion( I) As Byte 
End Type 


Type MONCBSTRUCT 

cb As Long 
aw Time As Long 
htask As Long 
dwRet As Long 
wType As Long 
wFmt As Long 
hConv As Long 
hszl As Long 
hsz2 As Long 
hData As Long 
dwDatal As Long 
dwData2 As Long 


cc As CONVCONTEXT 
cbData As Long 

Data(8) As Long 

End Type 


Type MONCONVSTRUCT 

cb As Long 
fConnect As Boolean 
dwlime As Long 
htask As Long 
hszSvc As Long 
hszTopic As Long 
hConvClient As Long 
hConvServer As Long 
End Type 


Type MONERRSTRUCT 

cb As Long 
w し astError As Long 
dwTime As Long 
htask As Long 
End Type 


Type MONHSZSTRUCT 

cb As Long 
fsAction As B(x)lean 
aw Time As Long 
hsz As Long 
htask As Long 
str As Byte 
End Type 


Type MONITOR—INFO—1 

pName As String 
End Type 


Type MONITOR JNFO 一 2 

pName As String 
pEnvironment As String 
pDl 丄 Name As String 
End Type 


Type MONLINKSTRUCT 

cb As Long 
aw Time As Long 
htask As Long 
fEstablished As Boolean 
fNoData As Boolean 
hszSvc As Long 
hszTopic As Long 
hszltem As Long 
wFmt As Long 
fServer As Boolean 
hConvServer As Long 
hConvClient As Long 
End Type 
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Type MONMSGSTRUCT 

cb As Long 
hwndTo As Long 
dwTime As Long 
htask As Long 
wMsg As Long 
wParam As Long 
IParam As Long 
dmhd As DDEML—MSG 

—HOOK 一 DATA 

End Type 

Type MOUSE_EVENT_RECORD 

dwMousePosition As COORD 
dwButtonStatc As Long 
dwControI Key Stale As Long 
dwEventFlags As Long 
End Type 


Type MOUSEHOOKSTRUCT 

pt As POINTAPI 
hwnd As Long 
wHitTestQxlc As Long 
dwExtralnfo As Long 
End Type 


Type MSG 
hwnd As Long 
message As Long 
wParam As Long 
IParam As Long 
time As Long 
pt As POINTAPI 
End Type 


Type MSGBOXPARAMS 

cbSize As Long 
hwndOwncr As Long 
hInstance As Long 
IpszText As String 
IpszCaption As String 
dwStylc As Long 
Ips/Icon As String 
dwContextHclpId As Long 
IpfnMsgBoxCallback As Long 
dwLanguageld As Long 
End Type 


Type MULTIKEYHELP 

mk^ize As Long 
nikKeylist As Byte 
sz Key phrase As String*253 
End Type 


Type NAME.BUFFER 

name As String*NCBNAMSZ 
name 一 num As Integer 
name_flags As Integer 
End Type 


Type NCB 

neb 一 command As Integer 
neb 一 retcode As Integer 
ncbjsn As Integer 
ncb_num As Integer 
ncb^bulTer As String 
nebjength As Integer 
ncb_callname As String*NCBNAMSZ 
ncb_namc As String*NCBNAMSZ 
neb^rto As Integer 
ncb.sto As Integer 
ncb_post As Long 
ncbjana_num As Integer 
ncb-CmcLcplt As Integer 
ncb_reserve(10) As Byte 
ncb_event As Long 
End Type 


Type NETRESOURCE 

dwScopc As Long 
dwType As Long 
dwDisplayType As Long 
dwUsagc As Long 
lpLocalNamc As Siring 
IpRemotcName As String 
lpCommcnt As String 
IpProvider As String 
End Type 


Type NEWTEXTMETRIC 

tmHeight As Long 
tmAscent As Long 
tmDcsccnt As Long 
tmlnternalLcading As Long 
tmExternal し eading As Long 
tmAveCharWidth As Long 
tmMaxCharWidth As Long 
tmWeight As Long 
tmOverhang As Long 
tmDigitizedAspectX As Long 
tmDigitizedAspectY As Long 
tmFirstChar As Byte 
tmLastChar As Byte 
tmDefaultChar As Byte 
tmBreakChar As Byte 
tmltalic As Byte 
tmUndcrlined As Byte 


tmStruckOut As Byte 
tmPitchAndFamily As Byte 
tmCharSet As Byte 
ntmFlags As Long 
ntmSizeEM As Long 
ntmCellHcight As Long 
ntmAveWidth As Long 
End Type 


Type NEWTEXTMETRICEX 

ntmTm As NEWTEXTMETRIC 
ntmFontSig As FONTSIGNATURB 
End Type 

Type NMHDR 

hwndFrom As Long 
idfrom As Long 
code As Long 
End Type 


Type NONCLIENTMETRICS 

cbSize As Long 
iBorderWidth As Long 
iScrollWidth As Long 
iScrollHeight As Long 
iCaptionWidth As Long 
iCaptionHcight As Long 
lfCaptionFont As LOG FONT 
iSMCaptionWidth As Long 
iSMCaptionHeight As Long 
lfSMCaptionFont As LOGFONT 
iMenuWidth As Long 
iMenuHcight As Long 
lfMenuFont As LOGFONT 
IfStatusFont As LOGFONT 
If'MessageFont As LOGFONT 
End Type 


Type NOTIFYICONDATA 

cbSize As Long 
hwnd As Long 
uID As Long 
uFlags As Long 
uCallbackMessagc As Long 
hlcon As Long 
szTip As String*64 
End Type 


Type NUMBERFMT 
NumDigits As Long 
LeadingZero As Long 
Grouping As Long 
lpDecimalSep As Siring 
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lpThousandScp As String 
NegativeOrder as Long 
End Type 


Type OFNOTIFY 
hdr As NMHDR 
lpOFN As OPENFILENAME 
pszFile As String 
End Type 


Type OFSTRUCT 
cBytes As Byte 
IPixedDisk As Byte 
nErrCodc As Integer 
Reserved 1 As Integer 
Reservcd2 As Integer 
szPathName(OFS_MAXPATH 

NAME) As Byte 

End Type 


Type OPENFILENAME 

IStructSize As Long 
hwndOwner As Long 
hInstance As Long 
IpstrFiltcr As String 
IpstrCustomFiltcr As String 
nMaxCustFilter As Long 
nFiltcrlndcx As Long 
IpstrFile As String 
nMaxFile As Long 
IpstrFileTitle As String 
nMaxFilcTitle As Long 
IpstrInitialDir As String 
IpstrTitle As String 
flags As Long 
nFilcOffset As Integer 
nFileExtcnsion As Integer 
IpstrDefExt As String 
lCustData As Long 
IpfnHook As Long 
IpTemplateName As String 
End Type 


Type OSVERSIONINFO 

dwOSVersionlnfoSize As Long 
dwMajorVersion As Long 
dwMinorVcrsion As Long 
dwBuildNumber As Long 
dwPlatformld As Long 
szCSDVersion As String* 128 
End Type 


Type OUTLINETEXTMETRIC 


otmSize As Long 

otmTextMetrics As TEXTMETRIC 
otmFiller As Byte 
otmPanoseNumber As PANOSE 
otmfsSelection As Long 
otmfsType As Long 
otmsCharSlopeRise As Long 
otmsCharSlopcRun As Long 
otmltalicAngle As Long 
otmEMSquare As Long 
otmAscent As Long 
otmDescent As Long 
otmLincGap As Long 
otmsCapEmHeight As Long 
otmsXHeight As Long 
otmrcFontBox As Rect 
otmMacAsccnt As Long 
otmMacDescent As Long 
otmMacLincGap As Long 
otmusMinimumPPEM As Long 
otmptSubscriptSizc As POINTAPI 
otmptSubscriptOffset As POINTAPI 
otmptSuperscriptSize As POINTAPI 
otmptSuperscriptOffset 

As POINTAPI 
otmsStrikeoutSize As Long 
otmsStrikeoutPosition As Long 
otmsUnderscorePosition As Long 
otmsUnderscoreSize As Long 
otmpFamilyName As String 
otnipFaceName As String 
otmpStylcName As String 
otmpFullNamc As String 
End Type 


Type OUTPUT 一 DEBUG_STRINGJNFO 

IpDebugStringData As String 
fUnicode As Integer 
nDebugStringLength As Integer 
End Type 


Type OVERLAPPED 

Internal As Long 
IntemalHigh As Long 
offset As Long 
OffsetHigh As Long 
hEvent As Long 
End Type 

Type PAGESETUPDLG 

IStructSize As Long 
hwndOwner As Long 
hDevMode As Long 


hDevNames As Long 
flags As Long 
ptPaperSize As POINTAPI 
rtMinMargin As Rect 
rtMargin As Rect 
hlnstance As Long 
lCustData As Long 
IpfnPageSetupHook As Long 
lpfnPagcPaintHook As Long 
IpPageSetupTemplateName 

As String 

hPagcSetupTemplate As Long 
End Type 


Type PAINTSTRUCT 

hdc As Long 
fErasc As Boolean 
rcPaint As Rect 
filestore As Boolean 
flncUpdate As B(x>lean 
rgbRescrvcd As Byte 
End Type 


Type PALETTEENTRY 

peRed As Byte 
peGreen As Byte 
pcBluc As Byte 
peFlags As Byte 
End Type 


Type PANOSE 
ulculture As Long 
bFamilyType As Byte 
bSerifStyle As Byte 
bWeight As Byte 
bProportion As Byte 
bContrast As Byte 
bStrokeVariation As Byte 
bArmStyle As Byte 
bLetterform As Byte 
bMidline As Byte 
bXHeight As Byte 
End Type 


Type PCMWAVEFORMAT 

wf As WAVEFORMAT 
wBitsPcrSample As Integer 
End Type 


Type PELARRAY 
paXCount As Long 
paYCount As Long 
paXExt As Long 
paYExt As Long 
paRGBs As Integer 
End Type 
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Type PERF 一 COUNTER_BLOCK 

ByteLength As Long 
End Type 


Type PERF 一 COUNTER ^DEFINITION 

ByteLength As Long 
CounterNameTitleIndcx As Long 
CounterNameTitlc As String 
CounterHelpTitleIndex As Long 
CountcrHelpTitlc As String 
DcfaultScale As Long 
DctailLevcl As Long 
CounterType As Long 
CounterSi/c As Long 
CounterOffsct As Long 
End Type 

Type PERF_DATA_BLOCK 

Signature As String*4 
LittleEndian As Long 
Version As Long 
Revision As Long 
Total ByteLength As Long 
HeaderLength As Long 
NumObjectTypes As Long 
DcfaultObjcct As Long 
SystemTimc As SYSTEMTIME 
PcrtTime As LARGEJNTEGER 
PcrfFrcq As LARGEJNTEGER 
PerTime l(X)nSec As 

LARGEJNTEGER 
SystemNamcLcngth As Long 
SystemNameOffset As Long 
End Type 


Type PERF.INSTANCE.DEFINITION 

ByteLength As Long 
ParentObjectTitlelndex As Long 
ParentOhjectlnstance As Long 
UniqucID As Long 
NameOffset As Long 
NameLcngth As Long 
End Type 


Type PERF 一 OBJECT 一 TYPE 

Total ByteLength As Long 
DctimtionLcngth As Long 
HeaderLength As Long 
ObjectNamcTitlelndcx As Long 
ObjectNamcTitlc As String 
ObjectHclpTitlelndex As Long 
ObjectHclpTitle As String 
DctailLevcl As Long 


NumCounters As Long 
DefaultCounter As Long 
Numlnstances As Long 
CcxlePage As Long 
PerfTime As LARGEJNTEGER 
PertPreq As LARGEJNTEGER 
End Type 


Type PIXELFORMATDESCRIPTOR 

nSize As Integer 
nVersion As Integer 
dwFlags As Long 
iPixelTypc As Byte 
cColorBits As Byte 
cRedBits As Byte 
cRedShift As Byte 
cGreenBits As Byte 
cGrecnShift As Byte 
cBlueBils As Byte 
cBlueShift As Byte 
cAlphaBits As Byte 
cAlphaShift As Byte 
cAccumBits As Byte 
cAccumRcdBits As Byte 
cAccumGrccnBits As Byle 
cAccumBlueBits As Byte 
cAccumAlphaBils As Byte 
cDepthBits As Byte 
cStcncilBits As Byte 
cAuxBuffers As Byte 
iLayerTypc As Byte 
bReserved As Byte 
dwLayerMask As Long 
dwVisibleMask As Long 
dwDamageMask As Long 
End Type 


Type POINTAPI 
x As Long 
y As Long 
End Type 


Type POINTFX 
x As FIXED 
y As FIXED 
Knd Type 


Type POINTL 
x As Long 
y As Long 
End Type 


Type POINTS 
x As Integer 
y As Integer 
End Type 


Type POLYTEXT 

x As Long 
y As Long 
n As Long 
IpStr As String 
uiFlags As Long 
rcl As Reel 
pdx As Long 
End Type 

Type PORT INFO 一 1 

pName As String 
End Type 


Type PORTJNFO_2 

pPortNamc As String 
pMonitorName As String 
pDescription As String 
tPortType As Long 
Reserved As Long 
End Type 


Type PRINTDLG 
IStructSi/c As Long 
hwndOwncr As Long 
hDevMtxle As Long 
hDevNames As Long 
hdc As Long 
flags As Long 
n From Page As Integer 
nToPage As Integer 
nMinPage As Integer 
nMaxPage As Integer 
nCopies As Integer 
hlnstance As Long 
ICustData As Long 
lpfnPrintH(X)k As Long 
IpfnSetupHook As Long 
IpPrintTempIateName As String 
IpSetupTemplateName As String 
hPrintTemplate As Long 
hSetupTempIate As Long 
End Type 


Type PRINTER_DEFAULTS 

pDatatype As String 
pDevMode As DEVMODE 
DesiredAccess As Long 
End Type 


Type PRINTER JNFOJ 

flags As Long 
pDescription As String 
pName As String 
pComment As String 
End Type 
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Type PRINTERJNFO_2 

pServcrName As String 
pPrinterNamc As String 
pShareName As String 
pPortName As String 
pDriverName As String 
pComment As String 
pLocation As String 
p Dev Mode As DEVMODE 
pSepFile As String 
pPrintProcessor As Siring 
pDatatype As String 
pParanieters As String 
pSecurityDescriptor As SECURITY 

.DESCRIPTOR 

Attributes As Long 
Priority As Long 
DefaultPriority As Long 
StartTimc As Long 
UntilTime As Long 
Status As Long 
cJobs As Long 
AveragePPM As Long 
End Type 


Type PRINTER JNFO_3 

pSecurityDescriptor As 

SECURITY.DESCRIPTOR 

End Type 


Type PRINTER JNFO_4 

pPrinterNamc As String 
pServcrName As String 
Attributes As Long 
End Type 


Type PRINTERJNFO_5 

pPrintcrName As String 
pPortName As String 
Attributes As Long 
DeviceNotSelectedTimeout As Long 
TransmissionRctryTimcout As Long 
End Type 


Type PRINTPROCESSOR JNFO J 

pName As String 
End Type 


Type PRIVILEGE_SET 

PnvilegeCount As Long 
Control As Long 

Privilege(ANYSIZE^ARRAY) As 
LUID_AND_ ATTRIBUTES 
End Type 


Type PROCESSJNFORMATION 

hProcess As Long 
hThread As Long 
dwProcessId As Long 
dwThreadld As Long 
End Type 

Type PROVIDORJNFOJI 

pName As String 
pEnvironment As String 
pD し LName As String 
End Type 

Type QUERY_SERVICE_CONFIG 

dwScrviccType As Long 
dwStartTypc As Long 
dwErrorControl As Long 
IpBinaryPathName As String 
IpLoadOrderGroup As String 
dwTagld As Long 
lpDcpendencies As String 
IpScrviceStartName As String 
IpDisplayName As String 
End Type 

Type UERY 一 SERVICE_LOCK—STATUS 

tlsLockcd As Long 
IpLockOwner As String 
dwLockDuration As Long 
End Type 

Type RASTERIZER.STATUS 

nSize As Integer 
wFlags As Integer 
nLanguagelD As Integer 
End Type 

Type RECT 
Left As Long 
r()p As Long 
Right As Long 
Bottom As Long 
End Type 

Type RECTL 
Left As Long 
Top As Long 
Right As Long 
Bottom As Long 
End Type 

Type RGBQUAD 
rgbBlue As Byte 


rgbGrecn As Byte 
rgbRcd As Byte 
rgbRcscrvcd As Byte 
End Type 


Type RGBTRIPLE 
rgbtBluc As Byte 
rgbtGrccn As Byte 
rgbtRcd As Byte 
End Type 


Type RGNDATA 

rdh As RGNDATAHEADER 
Buffer As Byte 
End Type 


Type RGNDATAHEADER 

dwSize As Long 
iType As Long 
nCouni As Long 
nRgnSize As Long 
rcBound As Rect 
End Type 


Type RIPJNFO 
dwError As Long 
dwType As Long 
End Type 


Type SCROLLINFO 

cbSizc As Long 
fMask As Long 
nMin As Long 
nMax As Long 
nPage As Long 
nPos As Long 
nTrackPos As Long 
End Type 


Type SECURITY^ATTRIBUTES 

nLength As Long 
IpSccurityDescriptor As Long 
blnheritHandle As Boolean 
End Type 


Type SECURITY.DESCRIPTOR 

Revision As Byte 
Sbzl As Byte 
Control As Long 
Owner As Long 
Group As Long 
Sacl As ACL 
Dacl As ACL 
End Type 
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Type SECURfTY 一 QUALITY 

_OF_SERVICE 

Length As Long 
Impersonationlevel As Integer 
ContextTrackingModc As Integer 
EffectivcOnly As B(X)lcan 
End Type 


Type SERVICE 一 STATUS 

dwScrviccTypc As Long 
dwCurrentState As Long 
dwControlsAccepted As Long 
dwWin32ExitCcxlc As Long 
dwServicewSpecificExitCocie 

As Long 

dwCheckPoint As Long 
dwWaitHint As Long 
End Type 

Type SERVICE_TABLE_ENTRY 

IpServiccName As String 
lpScrviccPr(K As Long 
End Type 


Type SESSION_BUFFER 

Isn As Integer 
State As Integer 

loca し name As String*NCBNAMSZ 
remote_nanie As 

Slring*NCBNAMSZ 
rcvs_outstanding As Integer 
scnds^oulstanding As Integer 
End Type 


Type SESSIONJHEADER 

sess_namc As Integer 
num_sess As Integer 
rcv_dg_outstanding As Integer 
rcv_any_outstanding As Integer 

End Type 

Type SHELLEXECUTEINFO 

cbSizc As Long 
fMask As Long 
hwnd As Long 
lpVcrb As String 
lpFile As String 
IpParameters As String 
IpDirectory As String 
nShow As Long 
hlnstApp As Long 
lpIDList As Long 
IpCIass As String 


hkeyClass As Long 
dwHotKey As Long 
hlcon As Long 
hProcess As Long 
End Type 


Type SHFILEINFO 

hlcon As Long 
ilcon As Long 
dwAttributes As Long 
s/DisplayNanie As 
Slring*MAX_PATH 

szTypcName As String*80 
End Type 

Type SHFILEOPSTRUCT 

hwnd As Long 
wFunc As Long 
pFrom As String 
pTo As String 
fFlags As Integer 

fAnyOpcrationsAborted As Boolean 
hNamcMappings As Long 
IpszProgressTitle As String 
End Type 


Type SHNAMEMAPPING 

pszOldPath As String 
pszNcwPath As String 
cchOldPath As Long 
cchNewPath As Long 
End Type 

Type SID AND.ATTRIBUTES 

Sid As Long 
Attributes As Long 
End Type 


Type SIDJDENTIFIER_AUTHORITY 

Value(6) As Byte 
End Type 

Type Size 
cx As Long 
cy As Long 
End Type 


Type SIZEL 
cx As Long 
cy As Long 
End Type 


Type SMALL 一 RECT 

Left As Integer 
Top As Integer 
Right As Integer 
Bottom As Integer 
End Type 


Type smpte 
hour As Byte 
min As Byte 
sec As Byte 
frame As Byte 
fps As Byte 
dummy As Byte 
pad(2) As Byte 
End Type 


Type STARTUPINFO 

cb As Long 
IpReserved As String 
lpDesktop As String 
lpTitlc As String 
dwX As Long 
dwY As Long 
dwXSi/e As Long 
dwYSize As Long 
dwXCountChars As Long 
dwYCountChars As Long 
dwFillAttribute As Long 
dwFlags As Long 
wShowWindow As Integer 
cbRcscrvcd2 As Integer 
lpRescrved2 As Byte 
hStdlnput As Long 
hStdOutput As Long 
hStdError As Long 
End Type 


Type STYLEBUF 
dwStyle As Long 
szDcscription As String*STYLE 

_DESCRIPTION_SIZE 

End Type 


Type SYSTEM.ALARM.ACE 

Header As ACE 一 HEADER 
Mask As Long 
SidStart As Long 
End Type 


Type SYSTEM.AUDIT.ACE 

Header As ACE_HEADER 
Mask As Long 
SidStart As Long 
End Type 
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Type SYSTEM JNFO 

dwOemID As Long 
dwPageSize As Long 
IpMinimumApplioaionAckinjss As Long 
IpMaximumApplicalionAcklress As Long 
dwActivePrcx:essorMask As Long 
dwNumberOrtProcessors As Long 
dwProcessorType As Long 
dwAlltKationGranularity As Long 
dw Reserved As Long 
End Type 

Type SYSTEM_POWER_STATUS 

ACLineStatus As Byte 
BalteryRag As Byte 
BatteryLifePerccnt As Byte 
Reserved 1 As Byte 
BatteryLiteTime As Long 
BatteryFullLifeTime As Long 
End Type 

Type SYSTEMTIME 

wYear As Integer 
wMonth As Integer 
vvDayOfWeek As Integer 
wDay As Integer 
wHour As Integer 
wMinutc As Integer 
wSecond As Integer 
wMilliseconds As Integer 
End Type 

Type Target 
dwType As Long 
dwDevicelD As Long 
wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
s/.Pnaiiie As String*MAXPNAMELEN 
End Type 

Type TEXTMETRIC 

tmHeight As Long 
tmAscent As Long 
tmDescent As Long 
tmlntemalLeading As Long 
tmExternalLeading As Long 
tmAveCharWidth As Long 
tmMaxCharWidth As Long 
tmWeight As Long 
tmOverhang As Long 
tmDigitizcdAspectX As Long 
tmDigitizedAspectY As Long 


tmFirstChar As Byte 
tmLastChar As Byte 
tmDefaultChar As Byte 
tmBrcakChar As Byte 
imltalic As Byte 
tmUnderlined As Byte 
tmStruckOut As Byte 
tmPitchAndFamily As Byte 
tmCharSct As Byte 
End Type 


Type TIME 一 ZONE—INFORMATION 

Bias As Long 

StandardName(32) As Integer 
StandardDate As SYSTEMTIME 
StandardBias As Long 
DaylightName(32) As Integer 
DaylightDate As SYSTEMTIME 
DaylightBias As Long 
End Type 


Type TIMECAPS 
wPeriodMin As Long 
wPeriodMax As Long 
End Type 


TypcTOKEN^GROUPS 

GroupCount As Long 
Groups(ANYSIZE.ARRAY) As 

SID_AND_ATTRIBUTES 

End Type 


Type TOKEN_PRIVILEGES 

PrivilegeCount As Long 
Privileges(ANYSIZE_ARRAY) As 
LUID.AN D^ATTRIB UTES 

End Type 


Type TPMPARAMS 
cbSize As Long 
rcExclude As Rect 
End Type 


Type TTPOLYCURVE 

wType As Integer 
cpfx As Integer 
apfx As POINTFX 
End Type 


Type TTPOLYGONHEADER 

cb As Long 
dwType As Long 
pfxStart As POINTFX 
End Type 


Type UNLOAD^DLL.DEBUGJNFO 

IpBaseOfDlI As Long 
End Type 

Type VS FIXEDFILEINFO 

dwSignature As Long 
dwStrucVcrsion As Long 
dwFilcVersionMS As Long 
dwFilcVersionLS As Long 
dwPrtxluctVersionMS As Long 
dwProductVcrsionLS As Long 
dwFileFlagsMask As Long 
dwFilcFlags As Long 
dwFilcOS As Long 
dwF ; ilcTypc As Long 
dwFileSubtype As Long 
dwFilcDatcMS As Long 
dwFileDateLS As Long 
End Type 

Type WAVEFORMAT 

wFormalTag As Integer 
nChanncls As Integer 
nSamplesPcrScc As Long 
nAvgBytesPerSec As Long 
nBlockAlign As Integer 
End Type 

Type WAVEHDR 
IpData As String 
dwBuffcrLcngth As Long 
dwBytcsRccorded As Long 
dwUser As Long 
dwFlags As Long 
dw Loops As Long 
IpNext As Long 
Reserved As Long 
End Type 

Type WAVEINCAPS 

wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
s/Pnanic As 

String*MAXPNAMELEN 
dwFormats As Long 
wChannels As Integer 
End Type 


Type WAVEOUTCAPS 

wMid As Integer 
wPid As Integer 
vDriverVersion As Long 
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s/Pname As Type WINDOWPLACEMENT 


String*MAXPNAMELEN 
dwForniats As Long 
wChannels As Integer 
dwSupport As Long 
End Type 

Type WIN32_FIND_DATA 

dwFileAttributes As Long 
ftCreationTime As FILETIME 
ftLastAccessTime As FILETIME 
ftLastWritcTime As FILETIME 
nFileSizeHigh As Long 
nFileSizeLow As Long 
dwRcscrvcdO As Long 
dwReserved I As Long 
cFileName As String*MAX_PATH 
cAltcrnate As String* 14 
End Type 

Type WIN32 一 STREAM JD 

dwStreamID As Long 
dwStreamAttributes As Long 
dwStreamSizeLow As Long 
dwStrcamSi/eHigh As Long 
dwStreamNameSize As Long 
cStrcamNamc As Byte 
End Type 

Type WINDOW—BUFFER_SCE 

^RECORD 

dwSize As COORD 
End Type 


Length As Long 
flags As Long 
showCmd As Long 
ptMinPosition As POINTAPI 
ptMaxPosition As POINTAPI 
rcNormalPosition As Rect 
End Type 

Type WINDOWPOS 
hwnd As Long 
hWndlnscrtAfter As Long 
x As Long 
y As Long 
cx As Long 
cy As Long 
flags As Long 
End Type 

Type WNDCLASS 
style As Long 
IpfnwndprtK As Long 
cbCIsextra As Long 
cbWndExtra2 As Long 
hlnstancc As Long 
hlcon As Long 
hCursor As Long 
hbrBackground As Long 
IpszMcnuName As String 
IpszClassName As String 
End Type 


Type WNDCLASSEX 

cbSize As Long 
style As Long 
lpfnWndPrcx: As Long 
cbCIsExtra As Long 
cbWndExtra As Long 
hInstance As Long 
hlcon As Long 
hCursor As Long 
hbrBackground As Long 
IpszMcnuName As String 
IpszClassName As String 
hlconSm As Long 
End Type 

Type XFORM 
eM 11 As Double 
eM 12 As Double 
cM21 As Double 
eM22 As Double 
eDx As Double 
eDy As Double 
End Type 
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付録 D Visual Basic 用定数一覧 



以下は、本害で扱っている API 関数が利用する定数をアルファべット顆に列挙した一 R である 0 
コーディングする際には、 Const ステートメントに統けて関数の定義をすること。メッセージに 
関する定数は 2 つめの表にまとめてある。利用方法やコーディングについては h.5 Visual 
Basic からの Windows API 呼び出し J を # 照してもらいたい 。 Visual C++ では、ヘッダファイル 
をインクルードすることで定義されるので特に利用する必要はない。 


• Win 32 定数一覧 


AC_LINE_BACKUP_POWER = &H2 
ACJJNE-OFFLINE = &H0 
AC_LINE_ONLINE = &HI 
AC_UNE_UNKNOWN = &HFF 
BACKUP 一 ALTERNATE_DATA = &H4 
BACKUP 一 DATA = &H1 
BACKUP_EA 一 DATA = &H2 
BACKUP.LINK = &H5 
BACKUP.SECURITY.DATA = &H3 
BATTERY 一 FLAG 一 CHARGING = &H8 
BATTER Y_FLAG_CRITICAL = &H4 
BATTERY_FLAG_HIGH = &H1 
BATTER Y_FLAG_LOW = &H2 
BATTERY_FLAG_NO_BATTERY = &H80 
BATTERY_FLAG_UNKNOWN = &HFF 
BATTERY 一 LlFE_UNKNOWN = &HFFFF 
BATTER Y_PERCENTAGEJJNKNOWN =&HFF 
BAUD.075 = &H1& 

BAUD_1I0 = &H2 & 

BAUD」1 5200 = &H 20000 
BAUD— 1200 = &H40& 

BAUD_128K = &HIOOOO 
BAUD_134_5 = &H4 & 

BAUD_I4400 = &H1000& 

BAUD_150 = &H8& 

BAUD__) = &_& 

BAUD. 19200 = &H 200 0& 

BAUD_2400 = &HI00& 

BAUD_30() = &HI0& 

BAUD, 38400 = &H 400 0& 

BAUD_48(X) = &H200& 

BAUD_56K = &H 8000& 

BAUD. 57600 = &H 40000 
BAUD 一 600 = &H20& 

BAUD 720() = &H400& 


BAUD. 9600 = &H800& 

BAUD.USER = &H10000000 
CBR_110= 110 
CBR_ 115200=115200 
CBR_ 1200 = 1200 
CBR_128(XX)=128(XX) 

CBR_14400= 14400 

CBR_ 19200 = 19200 

CBR_ 2400 = 2400 

CBR_ 256000 = 256000 

CBR_ 300 = 300 

CBR_ 38400 = 38400 

CBR_ 4800 = 4800 

CBR_ 56000 = 56000 

CBR_ 57600 = 57600 

CBR_600 = 600 

CBR_ 9600 = 9600 

CBR_BLOCK = &HFFFF 

CBS.AUTOHSCROLL = &H40& 

CBS_DISABLENOSCRO しし =&H800& 

CBS 一 DROPDOWN = &H2& 

CBS 一 DROPDOWNLIST = &H3& 
CBS.HASSTRINGS = &H200& 
CBS.NOINTEGRALHEIGHT = &H400 & 
CBS 一 OEMCONVERT = &H80& 

CBS 一 OWNERDRAWFIXED = &H10& 
CBS_OWNERDRAWVARIABLE = &H20& 
CBS 一 SIMPLE = &H1& 

CBS 一 SORT = &H100& 

CE—BREAK = &H 10 
CE_DNS = &H800 
CE 一 FRAME = &H8 
CE.IOE = &H400 
CE_MODE = &H 8000 
CE OOP = &H 1000 
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CE 一 OVERRUN = &H2 

CE-PTO = &H200 

CE 一 RXOVER = &Hl 

CE.RXPARITY = &H4 

CE_TXFULL = &HI00 

CLR .INVALID = &HFFFF 

CLRBREAK = 9 

CLRDTR = 6 

CLRRTS = 4 

CREATE.ALWAYS = 2 

CREATE 一 NEW =1 

CREATE 一 NEW_CONSO し E = &H10 

CREATE_NEW_PROCESS_GROUP =&H 200 

CREATE 一 NO_WlNDOW = &H 8000000 

CREATE 一 PROCESS_DEBUG_EVENT = 3 

CREATE.SUSPENDED = &H4 

CREATE 一 THREAD_DEBUG 一 EVENT = 2 

DATABITS_16 = &H10& 

DATABITS.16X = &H20& 

DATAB1TS 一 5 = &H1& 

DATABITS_6 = &H2& 

DATABITS_7 = &H4& 

DATABITS.8 = &H8& 

DDD_EXACT_MATCH_ON_REMOVE = &H4 

DDD_RAW_TARGET_PATH = &H1 

DDD_REMOVE_DEFINITION = &H2 

DEBUG_ONLY_THlS_PROCESS = &H2 

DEBUG_PRCX：ESS = &H1 

DETACHED 一 PROCESS = &H8 

DRIVE.CDROM = 5 

DRIVE.FIXED = 3 

DRIVE 一 RAMDISK = 6 

DRIVE 一 REMOTE = 4 

DRIVE 一 REMOVABLE = 2 

DRIVERVERSION = 0 

DRV_CANCEL = DRVCNF—CANCE し 

DRV 一 CLOSE = &H4 

DRV 一 CONFIGURE = &H7 

DRV_DISAB し E = &H5 

DRV.ENABLE = &H2 

DRV.EXITSESSION = &HB 

DRV_FREE = &H6 

DRV_INSTA しし =&H9 

DRV_LOAD = &Hl 

DRV MCI FIRST = DRV RESERVED 


DRV_MCI 一 LAST = DRV.RESERVED + &HFFF 

DRV_OK = DRVCNF_OK 

DRV 一 OPEN = &H3 

DRV.POWER = &HF 

DRV.QUERYCONFIGURE = &H8 

DRV_REMOVE = &HA 

DRV.RESERVED = &H800 

DRV_RESTART = DRVCNF 一 RESTART 

DRV_USER = &H 4000 

DTR_CONTROL_DISABLE = &H0 

DTR 一 CONTROL 一 ENABLE = &H 1 

DTR_CONTROL_HANDSHAKE = &H2 

EV_BREAK = &H40 

EV 一 CTS = &H8 

EV_DSR = &HI0 

EV.ERR = &H80 

EV_EVENT1 =&H800 

EV_EVENT2 = &H1000 

EV.PERR = &H200 

EV_RING = &H100 

EV_RLSD = &H20 

EV.RX80FULL = &H400 

EV_RXCHAR = &H1 

EV_RXFLAG = &H2 

EV 一 TXEMPTY = &H4 

EVENPARITY = 2 

EXCEPTION 一 CONTINUE_EXECUTION =-1 
EXCEFTION_CONTINUE_SEARCH = 0 
EXCEPTION_DEBUG_EVENT =1 
EXCEPTION_EXECUTE_HANDLER =1 
EXCEPTION_MAXIMUM_PARAMETERS =15 
EXIT_PROCESS_DEBUG_EVENT = 5 
EXIT_THREAD_DEBUG_EVENT = 4 
EXT_DEVICE_CAPS = 4099 
FILE 一 ADD 一 FILE = (&H2) 

FILE_ADD—SUBDIRECTORY = (&H4) 

FILE 一 ALL 一 ACCESS=(STANDARD_R1GHTS_ 

REQUIRED Or SYNCHRONIZE Or &H1FF) 
FILE_APPEND_DATA = (&H4) 
FILE_ATTRIBUTE_ARCHIVE = &H20 
FILE_ATTRIBUTE_COMPRESSED= &H800 
FILE_ATTRIBUTE_DIRECTORY = &H10 
FILE_ ATTRIBUTE 一 HIDDEN = &H2 
FILE_ATTRIBUTE_NORMAL = &H80 
FILE_ATTRIBUTE_READONLY = &H1 
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FILE_ATTRIBUTE_SYSTEM = &H4 
FILE_ATTR1BUTE_TEMP0RARY = &H100 
FILE.BEGIN = 0 

FILE_CASE_PRESERVED_NAMES = &H2 
FILE_CASE_SENSITIVE_SEARCH = &H1 
FILE_CREATE_PIPE_INSTANCE = (&H4) 
FILE.CURRENT =1 
FILE 一 DELETE 一 CHILD = (&H40) 

FILE 一 END = 2 
FILE.EXECUTE = (&H20) 

FILE 一 HLE 一 COMPRESSION = &H10 
FILE_FLAG_BACKUP_SEMANT1CS = &H 2000000 
FILE 一 FLAG-DELETE 一 ON_CLOSE= &H 4000000 
FILE_FLAG_NO_BUFFERING = &H 20000000 


FILE_FLAG_OVERLAPPED = &H 40000000 
FILE_FLAG_POSIX_SEMANTICS = &H 1000000 
FILE_FLAG_RANDOM_ACCESS = &H 10000000 
FILE—FLAG 一 SEQUENTIAL 一 SCAN = &H 8000000 
FILE_FLAG_WRITE_THROUGH = &H 80000000 
FILE_LIST_DIRECTORY = (&H1) 
FILE_MAP_ALL_ACCESS = SECTION_ALL_ACCESS 
FILE 一 MAP 一 COPY = SECTION_QUERY 
FILE_MAP_READ = SECTION_MAP_READ 
FILE_MAP_WRITE = SECTION_MAP_WRITE 
FILE_NOTIFY_CHANGE_ ATTRIBUTES = &H4 
FILE_NOTIFY_CHANGE_DIR_NAME = &H2 
FILE 一 NOTIFY 一 CHANGE 一 RLE 一 NAME = &H1 
FILE_NOTIFY 一 CHANGE 一 LAST 一 WRITE = &H10 
FILE_NOTIFY_CHANGE_SECURITY = &H100 
FILE 一 NOTIFY_CHANGE_SIZE = &H8 
FILE 一 PERSISTENT—ACLS = &H8 
FILE 一 READ 一 ATTRIBUTES = (&H80) 

FILE_READ 一 DATA = (&H1) 

FILE_READ_EA = (&H8) 

FILE_READ_PROPERTIES = FILE_READJEA 
FILE_SHARE_READ = &H1 


RLE 一 SHARE 一 WRITE = &H2 
FILE.TRAVERSE = (&H20) 

FILE 一 TYPE 一 CHAR = &H2 

FILE_TYPE_DISK = &H1 

FILE 一 TYPE_PIPE = &H3 

FILE_TYPE_REMOTE = &H 8000 

FILE 一 TYPE 一 UNKNOWN = &H0 

FILE 一 UNICODE 一 ON_DlSK = &H4 

FILE 一 VOLUMEJS 一 COMPRESSED = &H 8000 


FILE_WRITE_ ATTRIBUTES = (&H100) 
FILE_WRITE_DATA = (&H2) 

FILE_WRITE_EA = (&H10) 

FILE_WRITE_PROPERTIES = FILE 一 WRlTEjA 

FORMAT 一 MESSAGE_ALLOCATE』UFFER = &H100 

FORMAT 一 MESSAGE_ARGUMENT_ARRAY = &H 2000 

FORMAT_MESSAGE_FROM_HMODULE = &H800 

FORMAT_MESSAGE_FROM_STRING = &H400 

FORM AT 一 MESS AGE 一 FROM 一 SYSTEM = &H1000 

FORMAT 一 MESSAGEJGNOREJNSERTS = &H200 

FORMAT_MESSAGE_MAX_WIDTH_MASK = &HFF 

GET 一 TAPE_DRIVEJNFORMATION =1 

GET_TAPE 一 MEDIA JNFORMATION = 0 

GETCOLORTABLE = 5 

GETDEVICEUNITS = 42 

GETEXTENDEDTEXTMETRICS = 256 

GETEXTENTTABLE = 257 

GETFACENAME = 513 

GETPAIRKERNTABLE = 258 

GETPENWIDTH =16 

GETPHYSPAGESIZE =12 

GETPRINTINGOFFSET =13 

GETSCALINGFACTOR =14 

GETSETPAPERBINS = 29 

GETSETPAPERMETRICS = 35 

GETSETPRINTORIENT = 30 

GETSETSCREENPARAMS = 3072 

GETTECHNOLGY = 20 

GETTECHNOLOGY = 20 

GETTRACKKERNTABLE = 259 

GETVECTORBRUSHSIZE = 27 

GETVECTORPENSIZE = 26 

GMEM.DDESHARE = &H 2000 

GMEM_DISCARDABLE = &H100 

GMEM.DISCARDED = &H 4000 

GMEM.FIXED = &H0 

GMEM JNVALID.HANDLE = &H 8000 

GMEM.LOCKCOUNT = &HFF 

GMEM.LOWER = GMEM_NOT_BANKED 

GMEM_MODIFY = &H80 

GMEM.MOVEABLE = &H2 

GMEM_NOCOMPACT = &H10 

GMEM_NODISCARD = &H20 

GMEM_NOT 一 BANKED = &H1000 

GMEM NOTIFY = &H 4000 
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GMEM 一 SHARE = &H 2000 
GMEM 一 VALID_FLAGS = &H7F72 
GMEM—ZEROINIT = &H40 
IDLAPPLICATION = 32512& 

IDI 一 ASTERISK = 32516& 

ID し EXCLAM ATION = 32515& 

IDI 一 HAND = 32513& 

IDLQUESTION = 32514& 

IDIGNORE = 5 

IDLE_PRIORITY_CLASS = &H40 

IDNO = 7 

IDOK=1 

IDRETRY = 4 

IDYES = 6 

IE_BADID = (-I) 

IE_BAUDRATE = (-12) 

IE_BYTESIZE = (-11) 

IE-DEFAULT = (-5) 

IE 一 HARDWARE =(-10) 

IE 一 MEMORY = (-4) 

IE.NOPEN = (-3) 

IE_OPEN = (-2) 

IGNORE = 0 

LMEM_DISCARDAB し E = &HF00 
LMEM_DISCARDED = &H 4000 
LMEM.FIXED = &H0 
LMEM JNVALID.HANDLE = &H 8000 
LMEM.LOCKCOUNT = &HFF 
LMEM.MODIFY = &H80 
LMEM_MOVEABLE = &H2 
LMEM.NOCOMPACT = &H10 
LMEM_NODISCARD = &H20 
LMEMJVALID 一 FLAGS = &HF72 
LMEM.ZEROINIT = &H40 
LOAD_DLL_DEBUG_EVENT = 6 
LOCKFILE 一 EXCLUSIVE 一 LOCK = &H2 
LOCKFILE 一 FAILJMMEDIATELY = &H1 
LOGON32 一 LOGON_BATCH = 4 
LOGON32_LOGON—INTERACTIVE = 2 
LOGON32_LOGON 一 SERVICE = 5 
LOGON32_PROVIDER_DEFAULT = 0 
LOGON32_FROVIDER_WINNT35 =1 
LOGPIXELSX = 88 
LOGPIXELSY = 90 

LPTR = (LMEM_FIXED + LMEM.ZEROINIT) 


LPTx = &H80 

MARKPARITY = 3 

MAX.DEFAULTCHAR = 2 

MAX.LANA = 254 

MAX.LEADBYTES =12 

MAX.MONITORS = 4 

MAX_PATH = 32 

MAX-PRIORITY = 99 

MAXByte = &HFF 

MAXCHAR = &H7F 

MAXDWORD = &HFFFF 

MAXERROR し ENGTH =128 

MAXIMUM.ALLOWED = &H 2000000 

MAXLONG = &H7FFFFFFF 

MAXFNAMELEN = 32 

MAXSHORT = &H7FFF 

MAXSTRETCHBLTMODE = 4 

MAXWORD = &HFFFF 

MOVEFILE 一 COPY_ALLOWED = &H2 

MOVEFILE_DELAY_UNTIL 一 REBOOT = &H4 

MOVEFILE 一 REPLACE_EXISTING = &H1 

MS_CTS 一 ON = &H10& 

MS 一 DSR_ON = &H20& 

MSJMBF = ..MNBF" 

MS 一 RlNG_ON = &H40& 

MS 一 RLSD 一 ON = &H80& 

MSGF.DDEMGR = «&H 8001 

MSGF 一 D1ALOGBOX = 0 

MSGF 一 MAINLOOP = 8 

MSGF.MAX = 8 

MSGF.MENU = 2 

MSGF.MESSAGEBOX =1 

MSGF 一 MOVE = 3 

MSGF.NEXTWINDOW = 6 

MSGF.SCROLLBAR = 5 

MSGF.SIZE = 4 

MSGF.USER = 4096 

NMPWAIT 一 NOWAIT = &H1 

NMPWAIT 一 USE 一 DEFAULT_WA1T = &H0 

NMPWAIT 一 WAIT_FOREVER = &HFFFF 

NORMAL_PRIORITY_CLASS = &H20 

ODDPARITY =1 

OF.CANCEL = &H800 

OF_CREATE = &H1000 

OF.DELETE = &H200 
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OF 一 EXIST = &H 4000 
OF 一 PARSE = &H 100 
OF.PROMPT = &H 2000 
OF.READ = &H0 
OF.READWRITE = &H2 
OF 一 REOPEN = &H 8000 
OF 一 SHARE 一 COMPAT = &H0 
OF 一 SHARE 一 DENY_NONE = &H40 
OF_SHARE_DENY_READ = &H30 
OF_SHARE_DENY_WRITE = &H20 
OF_SHARE_EXCLUSIVE = &H10 
OF 一 VERIFY = &H400 
OF 一 WR1TE = &H1 

OFN.ALLOWMULTISELECT = &H200 
OFN 一 CREATEPROMPT = &H 2000 
OFN 一 ENABLEHOOK = &H20 
OFN_ENABLETEMPLATE = &H40 
OFN 一 ENABLETEMPLATEHANDLE = &H80 
OFN_EXPLORER = &H 80000 
OFN.EXTENSIONDIFFERENT = &H400 
OFN.FILEMUSTEXIST = &H1000 
OFN_HIDEREADONLY = &H4 
OFN.LONGNAMES = &H 200000 
OFN.NOCHANGEDIR = &H8 
OFN_NODEREFERENCELINKS = &H 100000 
OFN.NOLONGNAMES = &H 40000 
OFN_NONETWORKBUTTON = &H 20000 
OFN_NOREADONLYRETURN = &H 8000 
OFN_NOTESTFILECREATE = &H10000 
OFN.NOVALIDATE = &H100 
OFN 一 OVERWRITEPROMPT = &H2 
OFN.PATHMUSTEXIST = &H800 
OFN.READONLY = &H1 
OFN.SHAREAWARE = «&H 4000 
OFN.SHAREFALLTHROUGH = 2 
OFN_SHARENOWARN =1 
OFN_SHAREWARN = 0 
OFN.SHOWHELP = &H10 
OFS.MAXPATHNAME =128 
OPEN.ALWAYS = 4 
OPEN.EXISTING = 3 
OPENCHANNEL = 4110 
PARITY_EVEN = &H400& 

PARITY_MARK = &H800& 

PARITY^NONE = &H100& 


PARITY_ODD = &H200& 

PARITY^SPACE = &H1000& 

PCF_16BITMODE = &H200& 

PCF 一 DTRDSR = &H1& 

PCF.INTTIMEOUTS = &H80& 
PCF_PARITY_CHECK = &H8 & 

PCF.RLSD = &H4& 

PCF 一 RTSCTS = &H2& 

PCF_SETXCHAR = &H20& 

PCF 一 SPECIALCHARS = &H100& 

PCF_TOTA じ TIMEOUTS = &H40& 

PCF.XONXOFF = &H10& 

PIPE 一 ACCESS 一 DUPLEX = &H3 
PIPE 一 ACCESSJNBOUND = &H1 
PIPE_ACCESS 一 OUTBOUND = &H2 
PIPE 一 CLIENT_END = &H0 
PIPE 一 NOWAIT = &Hl 
PIPE_READMODE_BYTE = &H0 
PIPE_READMODE 一 MESSAGE = &H2 
PIPE 一 SERVER 一 END = &H1 
PIPE_TYPE 一 BYTE = &H0 
PIPE_TYPE 一 MESSAGE = &H4 
PIPE_UNLIMITED_INSTANCES = 255 
PIPE 一 WAIT = &H0 

PROCESS 一 HEAP 一 ENTRY_BUSY = &H4 

PROCESS_HEAP_ENTRY_DDESHARE = &H20 

PROCESS 一 HEAP_ENTRY_MOVEABLE = &H10 

PROCESS_HEAP 一 REGION = &HI 

PROCESS 一 HEAPJJNCO_nTED_RANGE = &H2 

PROFILE—KERNE し =&H 20000000 

PROFILE.SERVER = &H 40000000 

PROFILE JJSER = &H 10000000 

PROOF.QUALITY = 2 

PST_FAX = &H 2 1& 

PST_LAT = &H101& 

PST_NETWORK_BRIDGE = &H100& 

PST 一 PARALLELPORT = &H2& 

PST_RS232 = &H1& 

PST.RS422 = &H3& 

PST.RS423 = &H4& 

PST.RS449 = &H5 & 

PST_SCANNER = &H22 & 

PST_TCPIP 一 TELNET = &H102& 
PST_UNSPECIFIED = &H0& 

PST_X25 = &H103 & 
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PURGE.RXABORT = &H2 
PURGE.RXCLEAR = &H8 
PURGE 一 TX ABORT = &H1 
PURGE 一 TXCLEAR = &H4 
REALTIME.PRIORITY.CLASS = &H100 
RESETDEV = 7 

RTS_CONTROL_DISABLE = &H0 

RTS 一 CONTROL 一 ENABLE = &H1 

RTS_CONTRO し一 HANDSHAKE =： &H2 

RTS 一 CONTROL 一 TOGGLE = &H3 

S.ALLTHRESHOLD = 2 

S 一 FALSE = &H1 

S_LEGATO =1 

S—NORMAL = 0 

S_OK = &H0 

S 一 PERIOD1024 = I 

S_PERIOD2048 = 2 

S_PERIOD5l2 = 0 

S_PERIODVOICE = 3 

S_QUEUEHMPTY = 0 

S.SERBDNT = (-5) 

S.SERDCC = (-7) 

S 一 SER[)DR = (-14) 

S_SERDFQ = (-13) 

S_SERDLN = (-6) 

S_SERDMD = (-I0) 

S_SERDPT = (-12) 

S.SERDSH =(-11) 

S_SERDSR = (-I5) 

S 一 SERDST = (-16) 

S 一 SERDTP = (-8) 

S 一 SERDV し =(-9) 

S 一 SERDVNA =(-1) 

S.SERMACT = (-3) 

S_SEROFM = (-2) 

S_SERQFUL = (-4) 

S.STACCATO = 2 
SJTHRESHOLD =1 
S 一 WHITE 1024 = 5 
S_ WHITE 2048 = 6 
S_WHITE512 = 4 
S 一 WHITEVOICE = 7 
SCS_32BIT_BINARY = 0 
SCS_CAP_COMPSTR = &H1 
SCS 一 CAP 一 MAKEREAD = &H2 


SCS.CHANGEATTR = (GCS.COM PRE A DATTR 

Or GCS.COMPATTR) 

SCS—CHANGEC し AUSE = (GCS_ 

CX)MPREADCLAUSE Or GCS_COMPCLAUSE) 
SCS 一 DOS_BINARY =1 
SCS_OS216_BINARY = 5 
SCS 一 PIF 一 BINARY = 3 
SCS 一 POSlX_BINARY = 4 
SCS 一 SETSTR = (GCS.COMPREADSTR 

Or GCS_COMPSTR) 

SCS_WOW_BlNARY = 2 

SECURITY_ANONYMOUS_LOGON_RID = &H7 
SECURITY_BATCH_RID = &H3 
SECURITY_BUILTIN_DOMAIN_RID = &H20 
SECURITY_CONTEXT 一 TRACKING = &H4(KKX) 
SECURITY 一 CREATOR_GROUP 一 RID = &HI 
SECURITY 一 CREATOR 一 OWNER_RID = &H0 
SECURITY_DESCRIPTOR_MIN_LENGTH = (20) 
SECURITY_DESCRIPTOR_REVISION =(1) 
SECURITY_DESCRIPT0R_REVIS10N 1 =(1) 
SECUR1TY_DIALUP_RID = &H1 
SECURITY_EFFECTIVE_ONLY = &H 80000 
SECURITY JNTERACT1VE 一 RID = &H4 
SECURITY_LOCAL_RID = &H0 
SECURITY_LOCAL_SYSTEM_RID = &HI2 
SECURITY_LOGON JDS_R1D = &H5 
SECURITY_NHTWORK_RID = &H2 
SECURITY_NT_NON_UNIQUE = &H15 
SECURITY_NULL_RID = &H0 
SECURITY—SERVK ： E_RID = &H6 
SECURITY_SQOS_PRESENT = &H 100000 
SECURITY_VALID_SQOS_FLAGS = &H1F0000 
SECURITY 一 WOR し D 一 RID = &H0 
SEM_FAILCRITICALERRORS = &H1 
SEM.NOGPFAULTERRORBOX = &H2 
SEM_N 00 PENFI し EERRORBOX = &H 8000 
SET_ARC_DIRECTION = 4102 
SET_BACKGROUND_COLOR = 4103 
SET 一 BOUNDS = 4109 
SET_CLIP_BOX = 4108 
SET 一 MIRROR 一 MODE = 4110 
SET 一 POLY_MODE = 4104 
SET 一 SCREEN_ANGLE = 4105 
SET_SPREAD = 4106 
SET_TAPE_DRIVE_INFORMATION = I 
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SET 一 TAPE 一 MEDIAJNFORMATION = 0 

SETBREAK = 8 

SETCHARSET = 772 

SETCOLORTABLE = 4 

SETCOPYCOUNT =17 

SETDIBSCALING = 32 

SETDTR = 5 

SETKERNTRACK = 770 

SETUNECAP = 2I 

SETLINEJOIN = 22 

SctMitcrLimitC = 23 

SETRGBSTRING = M commdlg_SetRGBColor M 

SETRTS = 3 

SETXOFF =1 

SETXON = 2 

SP_APPABORT = (-2) 

SP 一 BAUD = &H2& 

SP_DATABITS = &H4& 

SP_ERROR = (-l) 

SP.HANDSHAKING = &HI0& 
SP_NOTREPORTED = &H4(XK) 
SP_OUTOFDISK = (-4) 
SP.OUTOFMEMORY = (-5) 

SP.PARITY = 

SP_PARITY_CHECK = &H20& 

SP_RLSD = &H40& 

SP.SERIALCOMM = &HI& 

SP_STOPBITS = &H8& 

SP_USERABORT = (-3) 

SPACEPARITY = 4 

STARTF.FORCEOFFFEEDBACK = &H80 
STARTF.FORCEONFEEDBACK = &H40 
STARTF_RUNFULLSCREEN = &H20 
STARTF 一 USECOUNTCHARS = &H8 
STARTF.USEFILLATTRIBUTE = &HI0 
STARTF.USEPOSITION = &H4 
STARTF.USESHOWWINDOW = &H1 
STARTF.USESIZE = &H2 
STARTF.USESTDHANDLES = &H100 
STD_ERROR_HANDLE = -I2& 
STD_INPUT_HANDLE = -IO& 
STD_OUTPUT 一 HANDLE = -ll& 

STOPBITS 一 I0 = &HI& 

STOPBITS_15 = &H2& 

STOPBITS_20 = &H4 & 


STREAM_CONTAlNS 一 SECURITY = &H2 

STREAM JV10DIFIED_WHEN_READ = &H1 

STRETCH 一 ANDSCANS =1 

TCLCP 一 STROKE = &H 4 

TC 一 CR 一 90 = &H8 

TC_CR_ANY = &H10 

TC 一 EA_DOUBLE = &H200 

TC 一 GP 一 TRAP = 2 

TC.HARDERR =1 

TC_IA_ABLE = &H400 

TC 一 NORMAL = 0 

TC_OP_CHARACTER = &HI 

TC_OP_STROKE = &H2 

TC_RA_ABLE = &H2(XK) 

TC 一 RESERVED = &H 8000 
TC 一 SA_CONTIN = &HI00 
TC_SA_DOUBLE = &H40 
TC 一 SAJNTEGER = &H80 
TC_SCROL し B じ T = &HI0000 
TC 一 SF 一 X_YINDEP = &H20 
TC 一 SIGNAL = 3 
TC 一 SO_AB し E = &HI(XX) 

TC_UA_ABLE = &H800 
TC_VA_ABLE = &H4(XK) 

TCLSRCCHARSET =1 
TCLSRCCODEPAGE = 2 
TCI.SRCFONTSIG = 3 
THREAD 一 BASE 一 PRIORITY JDLE =-15 
THREAD_BASE 一 PRIORITY_LOWRT=15 
THREAD 一 BASE 一 PRIORITY 31 AX = 2 
THREAD_BASE_PRIORITY_MIN = -2 
THREAD—PRIORrTY_ABOVE 一 NORMAL = 

(THREAD.PRIORITY.HIGHEST - I) 
THREAD_PRIORITY_BELOW_NORMAL = 

(THREAD_PRIORITY_LOWEST + 1) 
THREAD_PRIORITY_ERROR_RETURN = (MAXLONG) 
THREAD_PRIORITY_HIGHEST = 

THREAD_BASE_PRIORITY_MAX 
THREAD 一 PRIORITY JD し E = 

THREAD.BASE.PRIORITYJDLE 
THREAD_PRIORITY_LOWEST = 

THREAD_BASE_PRIORITY_MIN 
THREAD_PRIORITY_NORMAL = 0 
THREAD_PRIORITY_TIME_CRITICAL = 

thread.base.priority_lowrt 
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TIME.BYTES = &H4 

TIME 一 FORCE24HOURFORMAT = &H8 

TIME 一 MIDI = &H 10 

TIME_MS = &H1 

TIME.NOMINUTESORSECONDS = &H1 
TIME.NOSECONDS = &H2 
TIME_NOTIMEMARKER = &H4 
TIME_ONESHOT = 0 
TIME.PERIODIC =1 
TIME_SAMPLES = &H2 
TIME.SMPTE = &H8 
TIMEOUT.ASYNC = &HFFFF 
TIMERR.BASE = 96 

參 Win 32 メッセージ定数一餐 

WM.ACTIVATE = &H6 

WM.ACTIVATEAPP = &H1C 

WM 一 ASKCBFORMATNAME = &H30C 

WM.CANCEUOURNAL = &H4B 

WM—CANCELMODE = &H1F 

WM.CHANGECBCHAIN = &H30D 

WM_CHAR = &H102 

WM.CHARTOITEM = &H2F 

WM.CHILDACTIVATE = &H22 

WM 一 CHOOSEFONT 一 GETLOGFONT = (WM_USER + 1) 

WM 一 CHOOSEFONT 一 SETFLAGS = (WM.USER + 102) 

WM 一 CHOOSEFONT 一 SETLOGFONT 

=(WM_USER + 101) 

WM 一 CLEAR = &H303 
WM_CLOSE = &H10 
WM 一 COMM AND = &H1I1 
WM.COMMNOTIFY = &H44 
WM.COM PACTING = &H41 
WM.COMPAREITEM = &H39 
WM.CONVERTREQUESTEX = &HI08 
WM.COPY = &H301 
WM_COPYDATA = &H4A 
WM 一 CREATE = &H1 
WM 一 CTLCOLORBTN = &H135 
WM.CTLCOLORDLG = &H136 
WM.CTLCOLOREDIT = &H133 
WM 一 CTLCOLORUSTBOX = &H134 
WM 一 CTLCOLORMSGBOX = &H132 
WM.CTLCOLORSCROLLBAR = &H137 
WM CTLCOLORSTATIC = &H 138 


TIMERR_NOCANDO = (TIMERR.BASE + 1) 
T1MERR 一 NOERROR = (0) 

TIMERR—STRUCT = (TIMERR.BASE + 33) 
TLS 一 OUT_OFJNDEXES = &HFFFF 
TRUNCATE.EXISTING = 5 
TWOSTOPBITS = 2 
UNLOAD_DLL_DEBUG_EVENT = 7 
VER_PLATFORM_WIN32_NT = 2 
VER_PLATFORM_WIN32 一 WINDOWS =1 
VER_PLATFORM_WIN32s = 0 
VERTRES =10 
VERTSIZE = 6 


WM.CUT = &H300 

WM_DDE_ACK = (WM_DDE_FIRST + 4) 
WM.DDE.ADVISE = (WM^DDE.FIRST + 2) 
WM.DDE.DATA = (WM_DDE_FIRST + 5) 
WM_DDE_EXECUTE = (WM_DDE 一 FIRST + 8) 
WM.DDE^FIRST = &H3E0 
WM_DDE_INITIATE = (WM_DDE_FIRST) 
WM_DDE_LAST = (WM_DDE 一 FIRST + 8) 
WM_DDE_POKE = (WM_DDE 一 FIRST + 7> 
WM_DDE_REQUEST = (WM^DDE.FIRST + 6) 
WM_DDE_TERMINATE = (WM_DDE_FIRST + 1) 
WM_DDEJJNADVISE = (WM_DDE_FIRST + 3) 
WM.DEADCHAR = &HI03 
WM.DELETEITEM = &H2D 
WM.DESTROY = &H2 
WM.DESTROYCLIPBOARD = &H307 
WM.DEVMODECHANGE = &H1B 
WM.DRAWCLIPBOARD = &H308 
WM.DRAWITEM = &H2B 
WM.DROPFILES = &H233 
WM JBNABLE = &HA 
WM.ENDSESSION = &H16 
WM.ENTERIDLE = &H121 
WM.ENTERMENULOOP = &H211 
WM.ERASEBKGND = &H14 
WM^EXITMENULOOP = &H212 
WM 一 FONTCHANGE = &H1D 
WM.GETDLGCODE = &H87 
WM_GETFONT = &H 31 
WM GETHOTKEY = &H33 
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WM.GETMINMAXINFO = &H24 
WM 一 GETTEXT = &HD 
WM.GETTEXTLENGTH = &HE 
WM_HOTKEY = &H 312 
WM_HSCR0LL = &HI14 
WM_HSCROLLCLIPBOARD = &H30E 
WM JCONERASEBKGND = &H27 
WM JME_CHAR = &H286 
WM_IME—COMPOSITION = &H10F 
WM 」 ME_COMPOSITIONFULL = &H284 
WMJME 一 CONTROL = &H283 
WM_IME_ENDCOMPOSITION = &H10E 
WMJME 一 KEYDOWN = &H290 
WM JME 一 KEYLAST = &HI0F 
WMJME 一 KEYUP = &H291 
WMJME 一 NOTIFY = &H282 
WM JME_SELECT = &H285 
WM_IME_SETCONTEXT = &H281 
WM JME_STARTCOMPaSITION = &HI0D 
WMJNITDIALOG = &HI!0 
WMJNITMENU = «&H116 
WMJNITMENUPOPUP = &H117 
WM.KEYDOWN = &H100 
WM.KEYFIRST = &H1(X) 

WM_KEYLAST = &H108 
WM.KEYUP = &H10I 
WM_KILLFOCUS = &H8 
WM_LBUTTONDBLCLK = &H203 
WM_LBUTTONDOWN = &H20I 
WM.LBUTTONUP = &H202 
WM.MBUTTONDBLCLK = &H209 
WM.MBUTTONDOWN = &H207 
WM.MBUTTONUP = &H208 
WM_MDIACTIVATE = &H222 
WM.MDICASCADE = &H227 
WM_MDICREATE = &H220 
WM.MDIDESTROY = &H22I 
WM.MDIGETACTIVE = &H229 
WM.MDIICONARRANGE = &H228 
WM.MDIMAXIMIZE = &H225 
WM_MDINEXT = &H224 
WM_MDIREFRESHMENU = &H234 
WM.MDIRESTORE = &H223 
WM_MDISETMENU = &H230 
WM MD1TILE = &H226 


WM_MEASUREITEM = &H2C 
WM.MENUCHAR = &HI20 
WM.MENUSELECT = &HI1F 
WM_MOUSEACTIVATE = &H21 
WM.MOUSEFIRST = &H200 
WM.MOUSELAST = &H209 
WM.MOUSEMOVE = &H200 
WM_MOVE = &H3 
WM_NCACTIVATE = &H86 
WM_NCCALCSIZE = &H83 
WM_NCCREATE = &H81 
WM_NCDESTROY = &H82 
WM_NCHITTEST = &H84 
WM.NCLBUTTONDBLCLK = &HA3 
WM_NCLBUTTONDOWN = &HAI 
WM_NCLBUTTONUP = &HA2 
WM_NCMBUTTONDBLCLK = &HA9 
WM_NCMBUTTONDOWN = &HA7 
WM_NCMBUTTONUP = &HA8 
WM.NCMOUSEMOVE = &HAO 
WM_NCPAINT = &H85 
WM.NCRBUTTONDBLCLK = &HA6 
WM_NCRBUTTONDOWN = &HA4 
WM.NCRBUTTONUP = &HA5 
WM_NEXTDLGCTL = &H28 
WM_NULL = &H0 

WM 一 OTHERWINDOWCREATED = &H42 
WM_OTHERWINDOWDESTROYED = &H43 
WM 一 PAINT = &HF 
WM 一 PAINTCLIPBOARI) = &H309 
WM.PAINTICON = &H26 
WM_PALETTECHANGED = &H311 
WM.PALETTEISCHANGING = &H310 
WM.PARENTNOTIFY = &H2I0 
WM—PASTE = &H302 
WM.PENWINFIRST = &H380 
WM.PENWINLAST = &H38F 
WM.POWER = &H48 

WM_PSD_ENVSTAMPRECT = (WM.USER + 5) 
WM_PSD_FULLPAGERECT = (WM_USER + I) 
WM_PSD_GREEKTEXTRECT = (WM.USER + 4) 
WM_PSD_MARGINRECT = (WM.USER + 3) 
WM_PSD_MINMARGINRECT = (WM.USER + 2) 
WM_PSD_PAGESETUPDLG = (WM.USER) 
WM_PSD_YAFULLPAGERECT = (WM_USER + 6) 
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WM.QUERYDRAGICON = &H37 
WM_QUERYENDSESSION = &H1 1 
WM.QUERYNEWPALETTE = &H30F 
WM.QUERYOPEN = &H13 
WM.QUEUESYNC = &H23 
WM_QUIT = &H12 
WM^RBUTTONDBLCLK = &H206 
WM_RBUTTONDOWN = &H204 
WM_RBUTTONUP = &H205 
WM_RENDHRALLFORMATS = &H306 
WM_RENDERFORMAT = &H305 
WM_SETCURSOR = &H20 
WM_SETFOCUS = &H7 
WM 一 SETFONT = &H30 
WM.SETHOTKEY = &H32 
WM.SETREDRAW = &HB 
WM.SETTEXT = &HC 
WM 一 SHOWWINDOW = &H18 
WM SIZE = &H5 


WM_SIZECLIPBOARD = &H30B 
WM 一 SPOOLERSTATUS = &H2A 
WM 一 SYSCHAR = &H106 
WM.SYSCOLORCHANGE = &H15 
WM.SYSCOMMAND = &H112 
WM.SYSDEADCHAR = &H107 
WM.SYSKEYDOWN = &HI04 
WM.SYSKEYUP = &H105 
WM.TIMECHANGE = &H1E 
WM_TIMER = &H113 
WM_UNDO = &H304 
WM.USER = &H400 
WM_VKEYTOITEM = &H2E 
WM 一 VSCROL し = &H115 
WM_VSCRO し LCLIPBOARD = &H30A 
WM.WINDOWPOSCHANGED = &H47 
WM.WINDOWPOSCHANGING = &H46 
WM WININICHANGE = &H1A 
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